Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (D-E)
Guardian Procedure Calls Reference Manual—522629-013
4-68
DEVICE_GETINFOBYNAME_ Procedure
(Superseded on G-Series Releases)
DEVICE_GETINFOBYNAME_ Procedure
(Superseded on G-Series Releases)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Related Programming Manual
Summary
The DEVICE_GETINFOBYNAME_ procedure obtains the physical and logical
attributes of a device. The device is specified by name.
Syntax for C Programmers
•
CEXTDECS (via the included file TNSINTH) defines 32-bit values as the typedef
__int32_t which for TNS and TNS/R compiles is defined as
long and for TNS/E
compiles is defined as
int.
Note. On G-series releases, this procedure is supported for compatibility with previous
software and should not be used for new development. This procedure cannot obtain all of the
physical attributes of a device. For new development, call the CONFIG_GETINFO_BYNAME_
procedure.
#include <cextdecs(DEVICE_GETINFOBYNAME_)>
short DEVICE_GETINFOBYNAME_ ( char *devname
,short length
,[ short *logical-info ]
,[ short logical-info-maxlen ]
,[ short *logical-info-len ]
,[ short *primary-info ]
,[ short primary-info-maxlen ]
,[ short *primary-info-len ]
,[ short *backup-info ]
,[ short backup-info-maxlen ]
,[ short *backup-info-len ]
,[ __int32_t timeout ]
,[ short *error-detail ] );