Rockwell Automation Allen-Bradley ControlLogix 1756-MVI Programming Reference Manual page 78

4-26 CIP Messaging API
Publication 1756-RM004B-EN-P - October 2000
MVIcip_RegisterResetReqRtn
Syntax:
int MVIcip_RegisterResetReqRtn(
MVIHANDLE apiHandle,
MVICALLBACK (*resetrequest_proc)( ) );
Parameters:
apihandle handle returned by previous call to MVIcip_Open
resetrequest_proc pointer to reset request callback routine
Description:
This function is used by an application to register a reset request
callback routine. Once registered, the backplane device driver will call
resetrequest_proc if a module reset request is received.
apiHandle must be a valid handle returned from MVIcip_Open.
resetrequest_proc must be a pointer to a reset request callback function.
If the application does not register a reset request handler, receipt of a
module reset request will result in a software reset (i.e., reboot) of the
module. The application may register a reset request callback in order
to perform an orderly shutdown, reset special hardware, or to deny the
reset request.
Return Value:
MVI_SUCCESS
MVI_ERR_NOACCESS
Example:
MVIHANDLE apihandle;
// Register a reset request handler
MVIcip_RegisterResetReqRtn(apiHandle, resetrequest_proc);
See Also:
resetrequest_proc
routine was registered successfully
apihandle does not have access