Wait_For_Conversation

The Wait_For_Conversation call (function name cmwait) waits for an operation to complete that has been initiated when the processing_mode conversation characteristic was set to CM_NON_BLOCKING and CM_OPERATION_INCOMPLETE was returned in the return_code parameter.

CM_ENTRY Wait_For_Conversation(
  unsigned char FAR *conversation_ID,  
  CM_INT32 FAR *conversation_return_code,  
  CM_INT32 FAR *return_code            
);
 

Parameters

conversation_ID

Returned parameter. Specifies the identifier for the conversation on which the operation completed. The value of this parameter was returned by Initialize_Conversation or Accept_Conversation.

conversation_return_code

Returned parameter. Specifies the return_code from the operation that is completing. Its values will depend on which operation was originally issued.

return_code

The code returned from this call. The valid return codes are listed below.

Return Codes

cm_ok

Primary return code; the call executed successfully.

cm_system_event

Primary return code; the wait completed not because the operation completed but because some system event occurred.

cm_program_state_check

Primary return code; the program has no incomplete operation outstanding.

cm_product_specific_error

Primary return code; a product-specific error has occurred and has been logged in the product's error log.

State Changes

The state change is dependent on the operation that completed and its return code.

Remarks

The program must have an incomplete operation outstanding on some conversation.

See Also

Set_Processing_Mode, Specify_Windows_Handle