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
主要傳回碼;發生產品特定的錯誤，且已在產品錯誤記錄檔中記錄。

狀態變更

交談必須處於 SEND、RECEIVE 或 SEND_PENDING 狀態。

沒有狀態變更。