Extract_Conversation_State (CPI-C)
Extract_Conversation_State呼び出し (関数名 cmecs) は、指定された会話の状態を返します。
構文
CM_ENTRY Extract_Conversation_State(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *conversation_state,
CM_INT32 FAR *return_code
);
パラメーター
conversation_ID
指定されたパラメーター。 会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversation または Accept_Conversationによって返されました。
conversation_state
返されたパラメーター。 会話の状態を指定します。 次のいずれかの値になります。
CM_INITIALIZE_STATE
CM_SEND_STATE
CM_RECEIVE_STATE
CM_SEND_PENDING_STATE
CM_CONFIRM_STATE
CM_CONFIRM_SEND_STATE
CM_CONFIRM_DEALLOCATE_STATE
return_code
この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。
リターン コード
CM_OK
プライマリ リターン コード。呼び出しが正常に実行されました。
CM_PROGRAM_PARAMETER_CHECK
プライマリ リターン コード。 conversation_ID で指定された値が無効です。
CM_PRODUCT_SPECIFIC_ERROR
プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。
State Changes (状態の変化)
会話は RESET 以外の任意の状態にすることができます。
状態の変更はありません。