Cc_errstr – Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual

Page 152

Advertising
background image

API Library of Routines

Appendix B

CC_ERRSTR

B-21

Copies the “canned” null-terminated error message into the user’s
local buffer.

C Syntax

#include <copro.h>

void CC_ERRSTR (error,err_ptr)

unsigned error;

unsigned char *err_ptr;

Parameters

error

Specifies which error message to copy. The number is typically
supplied by the status returned from an API function call or the I/O
status returned in iostat.

err_ptr

This parameter specifies an 80-character buffer to which the error string
will be copied

.

Returns

None.

Description

Use the CC_ERRSTR function to copy the “canned” error message
corresponding to an error number into the user’s local buffer. This error
number is typically the value of the iostat variable or the return status of an
API function. We recommend that you use this function in a BASIC
procedure, although you can use it in a C routine. See CC_ERROR for a
C routine.

CC_ERRSTR

Advertising