Test_Request_To_Send_Received (CPI-C)

  • [アーティクル]

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を発行しませんでした。 この値は、 return_codeに CM_OK 以外の値が含まれている場合は関係ありません。

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

リターン コード

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

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。 conversation_ID で指定された値が無効であるか、変数のアドレスが無効です。

CM_PROGRAM_STATE_CHECK
主なリターン コード。会話が SEND、RECEIVE、またはSEND_PENDING以外の状態です。

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

State Changes (状態の変化)

会話は、SEND、RECEIVE、またはSEND_PENDING状態である必要があります。

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