Test_Request_To_Send_Received呼び出し (関数名 cmtrts) は、要求対送信通知がパートナー・プログラムから受信されたかどうかを判別します。
構文
CM_ENTRY Test_Request_To_Send_Received(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *request_to_send_received,
CM_INT32 FAR *return_code
);
パラメーター
conversation_ID
指定されたパラメーター。 会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversation または Accept_Conversationによって返されました。
request_to_send_received
返されたパラメーター。 要求から送信への受信インジケーター。 使用可能な値は次のとおりです。
CM_REQ_TO_SEND_RECEIVED
Request_To_Send 発行されたパートナー プログラムは、会話を RECEIVE 状態に変更するようローカル プログラムに要求します。
CM_REQ_TO_SEND_NOT_RECEIVED
パートナー プログラムは Request_To_Sendを発行しませんでした。 CM_OK以外 の値return_code 含まれている場合、この値は関係ありません。
return_code
この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。
リターン コード
CM_OK
プライマリ リターン コード。呼び出しが正常に実行されました。
CM_PROGRAM_PARAMETER_CHECK
プライマリ リターン コード。 conversation_ID で指定された値が無効であるか、変数のアドレスが無効です。
CM_PROGRAM_STATE_CHECK
プライマリ リターン コード。会話が SEND、RECEIVE、または SEND_PENDING 以外の状態です。
CM_PRODUCT_SPECIFIC_ERROR
プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。
状態の変更
会話は、SEND、RECEIVE、またはSEND_PENDING状態である必要があります。
状態の変更はありません。