Rockwell Automation 1747-PCIS API Software - Open Controller - Manual (Page 74)

Publication 1747-UM002A-US-P - June 2000
6-14 Library of Routines
Description:
This function enables or disables the scanner from scanning the
module in a specific
slotnum . This applies to both the input and
output scan. Slots that are disabled are not included in the I/O scan.
By default, all slots are enabled.
Return Value:
Considerations:
Supported in the DOS API library and the Windows NT API library
Example:
HANDLE Handle;
int retcode;
retcode = OC_EnableSlot( Handle, 6, SLOT_DISABLE ); /*
Exclude slot 6 */
OC_ErrorMsg OC_ErrorMsg returns a descriptive text message associated with the
API return value
errcode .
Syntax:
int OC_ErrorMsg(int errcode, char **msg);
Description:
The null-terminated message string is placed in a static buffer that is
reused each time this function is called. A pointer to this buffer is
returned in
msg .
Name: Value: Description:
SUCCESS 0 module was updated successfully
ERR_OCACCESS 2 handle does not have access to scanner
ERR_OCNOFORCES 15 no forces installed, scanner cannot enable forces
ERR_OCPARAM 8 parameter contains invalid value
ERR_OCRESPONSE 10 scanner did not respond to request
ERR_OCSCANCFG 14 scanner has not been configured