Wait_For_Conversation呼び出し (関数名 cmwait) は、processing_mode会話特性がCM_NON_BLOCKINGに設定され、return_codeパラメーターでCM_OPERATION_INCOMPLETEが返されたときに開始された操作が完了するまで待機します。
構文
CM_ENTRY Wait_For_Conversation(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *conversation_return_code,
CM_INT32 FAR *return_code
);
パラメーター
conversation_ID
返されたパラメーター。 操作が完了した会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversation または Accept_Conversationによって返されました。
conversation_return_code
返されたパラメーター。 完了する操作の return_code を指定します。 その値は、最初に発行された操作によって異なります。
return_code
この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。
リターン コード
CM_OK
プライマリ リターン コード。呼び出しが正常に実行されました。
CM_SYSTEM_EVENT
プライマリ リターン コード。操作が完了したためではなく、システム イベントが発生したために待機が完了しました。
CM_PROGRAM_STATE_CHECK
プライマリ リターン コード。プログラムに未完了の操作がありません。
CM_PRODUCT_SPECIFIC_ERROR
プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。
状態の変更
状態の変更は、完了した操作とそのリターン コードによって異なります。
注釈
プログラムは、一部の会話で未完了の操作を完了している必要があります。