Wait_For_Conversation (CPI-C)
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
プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。
State Changes (状態の変化)
状態の変更は、完了した操作とその戻りコードによって異なります。
注釈
プログラムには、何らかの会話で未完了の操作が未完了である必要があります。