beautypg.com

Paxar Gold 6037EX User Manual

Page 64

background image

4-28 Programmer’s Manual

p c l G e t E r r o r M s g

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.