Measurement Computing Personal488 rev.3.0 - Manual (Page 89)

Personal488 for Windows 95/98/Me/NT/2000 04-10-01 API Reference 6-21
GetErrorList
Syntax ErrorCodeT WINAPI GetErrorList(DevHandlePT devHandleList,
LPSTR errText, DevHandlePT errHandle);
DevHandleList is a pointer to a list of external devices that was returned from a function,
due to an error associated with one of the external devices in the list.
errText is the text string that contains the error message. You must ensure that the string
length is at least 247 bytes.
errHandle is a pointer to the device handle that caused the error.
Returns -1 if error
otherwise, it returns the error number associated with the given list of devices.
Bus States None
Example char errText[329];
int errHandle;
int errnum;
result = ClearList(list);
if (result == -1) {
errnum=GetErrorList(list,errText,&errHandle);
printf(“Error %d;%s,at handle %d\n”, errnum, errText,
errHandle);
}
See Also Error, GetError, Status
The GetErrorList command is user-called, after another function identifying a list of device handles,
returns an error indication. The device handle list sent to the function that returned the error indication, is
sent to
GetErrorList . GetErrorList finds the device that returned the error indication, returning the
handle through errHandle , and returns the error code associated with that error. If a non-null error text
pointer is passed, GetError also fills in up to 247 bytes in the string. The application must ensure that
sufficient space is available.