Set_Processing_Mode (CPI-C)

Set_Processing_Mode呼び出し (関数名 cmspm) は、要求した操作が完了したときに後続の呼び出しが返されるか (ブロック)、操作が開始された直後 (非ブロッキング) かを会話に指定します。

Note

Specify_Windows_Handle呼び出しで hWnd によって識別された WndProc に送信された、Wait_For_Conversationまたは Microsoft® Windows® メッセージを介して、非ブロッキング呼び出しが完了すると、プログラムに通知されます。

構文

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

パラメーター

conversation_ID
指定されたパラメーター。 会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversation または Accept_Conversationによって返されました。

receive_type
指定されたパラメーター。 会話に対する後続の呼び出しをブロックするか、ブロックしないかを指定します。 次のいずれかの値になります。

CM_BLOCKING
後続の呼び出しは、操作が完了したときにのみを返します。

CM_NON_BLOCKING
後続の呼び出しは、操作が開始された直後に返されます。

return_code
この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。

リターン コード

CM_OK
主なリターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_STATE_CHECK
主なリターン コード。会話に対する以前の不完全な操作はまだ完了していません。

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。 conversation_ID または processing_mode で指定された値が無効です。

CM_PRODUCT_SPECIFIC_ERROR
主なリターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

会話は RESET 以外の任意の状態にすることができます。

状態の変更はありません。