Rail Utility and Error Handling Functions

PCRSGetError

HRESULT _PCRSFN PCRSGetError(int *errno)

• errno: Pointer to an integer where the current error number will be placed.

PCRSGetErrorString

HRESULT _PCRSFN PCRSGetErrorString(int errorCode, char *buffer, int bufSize, int *numchars)

• errorCode: Error code returned by an API function (or PCRSGetError).
• buffer: Character buffer where the error message (description) will be placed.
• bufSize: Maximum number of bytes that can be copied into buffer.
• numchars: Actual number of bytes copied to buffer.

PCRSSetDebug (Deprecated in Version 22)

HRESULT _PCRSFN PCRSSetDebug(int level, int *oldLevel)

• level: New debug level setting for DLL (0 - 19, 19 produces most debug messages).
• oldLevel: Pointer where the previous debug level will be placed.

PCRSGetDebug (Deprecated in Version 22)

HRESULT _PCRSFN PCRSGetDebug(int *debugLev)

• debugLev: Pointer where the current debug level will be placed.

PCRSAbout

HRESULT _PCRSFN PCRSAbout(const char *which, char *buffer, int bufSize, int *numchars)

• which: String identifying the product version/name information desired (e.g., "ProductName", "ProductVersion"). The product version is defined in the PCRWINxx\user.cfg file.
• buffer: Character buffer where the About info will be placed.
• bufSize: Maximum number of bytes that can be copied into buffer.
• numchars: Actual number of bytes copied to buffer.

PCRSSendAboutInfo (Deprecated in Version 22)

HRESULT _PCRSFN PCRSSendAboutInfo()