RP1210_GETLASTERRORMSG (): Notes

Added to RP 1210B, this function is called to get a more descriptive subordinate error code and textual representation of the last error code for a particular ClientID  . The application/thread/process passes the last error code received (in the ErrorCode  parameter) and the function returns a more descriptive subordinate error code (in the SubErrorCode  parameter) along with a textual message that can be delivered to the end-user (in thefpchDescription  parameter).

• This function is not intended to supersede the RP1210_GetErrorMsg  function. RP1210_GetErrorMsg  can be called at any time, whereas this function is intended to be called immediately after a failed API call like the Windows API call GetLastError (  ).
• The subordinate error code shall be a mnemonic defined in this document.
• For more information on why this function was added, see Section 10.2, Error Code 142 ERR HARDWARE NOT RESPONDING and Backward Compatibility  .