Avery Dennison 6035 Programmer Manual Rev.CA 6/01 - Manual (Page 69)

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.
Example
#include
#include "mmsultra.h"
void main(void)
{
short sStatus = 0; // Command calls status
short usStatus = 0; // Command calls status