A SERVICE OF

logo

4-28 Programmer’s Manual
pclGetErrorMsg
Description
Testing/Debugging Only. Retrieves a pointer to the error
message corresponding to a specified error number. Use this
function on error numbers returned by pclOpen, pclWrite, and
pclStatus.
Many error messages are longer than 20 characters. An
application must format the message before displaying it to
avoid truncation. See “Display” in Chapter 2 for more
information.
Error numbers that this function can retrieve
must be positive. Zero indicates success,
and negative numbers are ROM-DOS errors.
Syntax
char far* far pclGetErrorMsg(unsigned short usMsgNo);
Parameters
usMsgNo
The error number.
Return Values
Pointer to a null-terminated
message string
Successful.
0
Unsuccessful.