Guardian Procedure Calls Reference Manual

specific-info:specific-maxlen
output:input
STRING .EXT:ref:1, INT:value
specifies an area where the device-specific information will be returned. If specific-info
is zero or if specific-maxlen is zero, then no device-specific data is returned. Each device
type or subtype might return a different set of data. See Structure Definitions for specificinfo
(page 191) for a detailed description of the structure and values of this buffer.
If the returned device-specific information is too large to fit into the buffer, the actual data is
truncated to fit; however, specific-len is set to reflect the number of bytes that would have
been returned if the buffer had been large enough.
specific-len
output
INT .EXT:ref:1
if specific-info is not 0 and specific-maxlen is greater than 0, this parameter is
returned if its value is not 0. The value returned reflects the full size of the device-specific
information, even if it is larger than the specific-maxlen value. The actual number of bytes
copied into specific-info is the smaller of specific-maxlen and specific-len
bytes. If the value returned by this procedure is nonzero, this parameter is returned as 0.
timeout
input
INT(32):value
specifies how many hundredths of a second the procedure waits for a response from the device.
If 0 is passed, the timeout value is set to its default (6000D or 1 minute). If -1D is passed, the
procedure does not time out.
error-detail
output
INT(32) .EXT:ref:1
If error-detail is not 0, then an error-dependent value is returned. See Returned Value.
Returned Value
INT(32)
Outcome of the call:
Device found and data is returned. The value of error-detail is set to zero. Only if error is returned as
zero will there be any meaningful data in common-info or specific-info.
0D
Device or subtype 30 process returned an error. The error is reported in error-detail. An error-detail
value of 40 indicates that the I/O process did not respond within the timeout interval. An error-detail
value of 14 indicates that the device was not found.
1D
Required parameter is invalid. The value of error-detail is set to the ordinal number of the invalid
parameter.
2D
Bounds error; a reference parameter contained an invalid address. The value of error-detail is set to
the ordinal number of the invalid parameter.
3D
Device returned error or invalid data to the inquiry. If error-detail is -1, then the device returned zero
and the response is invalid. Otherwise, error-detail is the value of the error returned to the inquiry by
the device.
4D
CONFIG_GETINFO_BYNAME2_ Procedure 199