通过

Set_Receive_Type (CPI-C)

  • 项目

Set_Receive_Type调用 (函数名称 cmsrt) 指定程序在后续接收调用中接收数据的方式。 它替代由 Initialize_Conversation 或 Accept_Conversation 调用建立的默认接收类型。 默认情况下，如果发出 接收 调用时数据不可用，程序会等待数据到达。

接收类型值会影响所有后续 接收 调用。 可以通过重新发出 Set_Receive_Type来更改它。

语法

  
CM_ENTRY Set_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *receive_type,            
  CM_INT32 FAR *return_code              
);

参数

conversation_ID
提供的参数。 指定会话的标识符。 此参数的值由 Initialize_Conversation 或 Accept_Conversation 返回。

receive_type
提供的参数。 指定程序 在后续接收 调用中如何接收数据。 可能的值为：

CM_RECEIVE_AND_WAIT
本地计划接收合作伙伴计划当前提供的任何数据。 如果没有可用的数据，则本地程序将等待数据到达。

CM_RECEIVE_IMMEDIATE
本地计划接收合作伙伴计划当前提供的任何数据。 如果没有可用数据，则本地程序不会等待。

return_code
此调用返回的代码。 本主题稍后将列出有效的返回代码。

返回代码

CM_OK
主返回代码;已成功执行的调用。

CM_PROGRAM_PARAMETER_CHECK
主返回代码; conversation_ID 或 receive_type 指定的值无效，或者变量的地址无效。

CM_PRODUCT_SPECIFIC_ERROR
主返回代码;发生特定于产品的错误，并且已记录在产品错误日志中。

状态更改

会话可以处于除 RESET 以外的任何状态。

没有状态更改。