Set_Processing_Mode

The Set_Processing_Mode call (function name cmspm) specifies for the conversation whether subsequent calls will be returned when the operation they have requested is complete (blocking) or immediately after the operation is initiated (nonblocking).

Note  A program is notified of the completion of nonblocking calls when it issues Wait_For_Conversation or through a Windows message sent to a WndProc identified by the hWnd in the Specify_Windows_Handle call.

CM_ENTRY Set_Processing_Mode(
  unsigned char FAR *conversation_ID,  
  CM_INT32 FAR *receive_type,          
  CM_INT32 FAR *return_code            
);
 

Parameters

conversation_ID

Supplied parameter. Specifies the identifier for the conversation. The value of this parameter was returned by Initialize_Conversation or Accept_Conversation.

receive_type

Supplied parameter. Specifies whether subsequent calls on the conversation will be blocking or nonblocking. Possible values are:

CM_BLOCKING

Subsequent calls will return only when the operation is complete.

CM_NON_BLOCKING

Subsequent calls will return immediately once the operation has been initiated.

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_program_state_check

Primary return code; the previous incomplete operation on the conversation has not yet completed.

cm_program_parameter_check

Primary return code; the value specified by conversation_ID or processing_mode is invalid.

cm_product_specific_error

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

State Changes

The conversation can be in any state except RESET.

There is no state change.