Advantage Client Engine
Retrieves the error string for the given error code
UNSIGNED32 |
AdsGetErrorString (UNSIGNED32 ulErrCode, UNSIGNED8 *pucBuf, UNSIGNED16 *pusBufLen); |
ulErrCode (I) |
An Advantage error code. |
pucBuf (O) |
Return the generic error string for ulErrCode. |
pusBufLen (I/O) |
Length of given buffer on input, length of returned data on output. |
AdsGetErrorString is used to retrieve the error string for a specific error code. Errors that occur in the Advantage Client Engine are 5000 class errors. There are also relevant error messages built into the Advantage Client Engine for server and communications layer errors. By calling AdsGetErrorString, AdsShowError, or AdsGetLastError an application can display immediate information on failures that have occured.
AdsGetLastError can also be used to return information about any valid Advantage error code. When used immediately after an Advantage Client Engine error occurs, additional error information will be returned.