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_ConversationAccept_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 状态。

没有状态更改。