IOtech Personal488, Руководство пользователя

Страница: 89 / 150

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.