get_diag_att

Edit online

Purpose

Reads an attribute from the predefined database PDiagAtt.

Syntax


#include    <diag/modid.h>
 
int get_diag_att ( type, attribute, conversion, byte_count, value )
 
char *type;
char *attribute;
char conversion;
int  *byte_count;
void *value;

Description

The get_diag_att subroutine gets attributes from the predefined diagnostic database PDiagAtt.

Parameters

The arguments are defined as follows:

Parameter Description
type Device type, which should be Class/SubClass/Type string. This fully qualified string reduces the chance of finding two objects having the same Type value in the PdDv object class.
attribute Attribute name to get from the Predefined Attribute Object Class.
conversion The data type to which the attribute is to be converted, including the following:
`s' = string
rep = s
`b' = byte sequence
rep = s (for example "0x56FFE67")
`l' = long
rep = n
`i' = int
rep = n
`h' = short (half)
rep = n
`f' = float
rep = n
`c' = char
rep = n, or s
`a' = address
rep = n
byte_count Number of bytes (for byte sequence only).
value Pointer to where the converted attribute value is returned.

Return Value

Upon successful completion, a value of 0 is returned. Otherwise, a value of -1 is returned.