HP-UX SNAplus2 CPI-C Programmer's Guide (June 2003)

CPI-C Calls
Check_For_Completion (cmchck)
Chapter 3 133
This value is relevant only if the return_code
parameter is set to CM_OK.
return_code Possible values are:
CM_OK The call executed successfully. A
previously outstanding call on the
conversation specified by
conversation_ID has completed.
CM_PROGRAM_STATE_CHECK There are no previously
incomplete calls outstanding. Either
the application has not issued any
calls that returned
CM_OPERATION_INCOMPLETE,orithas
already issued
Wait_For_Conversation to obtain the
results of all such calls.
CM_UNSUCCESSFUL There is at least one previously
incomplete call outstanding, but none
has yet completed. The application
should continue with other
processing and retry
Check_For_Completion later. (This
return code is different from
CM_PROGRAM_STATE_CHECK.)
State When Issued
The call is not associated with a specific conversation, so the
conversation state is not relevant. However, the application must have at
least one conversation with an incomplete operation outstanding.
State Change
There is no state change.
Usage Notes
If the return code from Check_For_Completion is CM_OK, the application
should call Wait_For_Conversation to obtain the results of the
outstanding call.