通过

Set_Fill (CPI-C)

  • 项目

Set_Fill调用 (函数名称 cmsf) 指定程序是接收逻辑记录形式的数据，还是以指定的数据长度接收数据。 此调用仅在基本对话中允许。

语法

  
CM_ENTRY Set_Fill(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *fill,                    
  CM_INT32 FAR *return_code              
);

参数

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

fill
提供的参数。 指定程序接收数据的形式。 可以选择下列选项：

CM_FILL_BUFFER
本地程序接收数据，直到达到 Receive 调用的 requested_length 参数指定的字节数或数据末尾。 接收数据时不考虑逻辑记录格式。

CM_FILL_LL
以逻辑记录格式接收数据。 接收的数据可以是完整的逻辑记录、等于 Receive 调用的 requested_length 参数的逻辑记录的一部分，也可以是逻辑记录的末尾。

return_code
从此调用返回的代码。 本主题后面列出了有效的返回代码。

返回代码

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

CM_PROGRAM_PARAMETER_CHECK
主返回代码;发生以下情况之一：

  • conversation_ID或填充指定的值无效。

  • 映射当前会话。

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

状态更改

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

没有状态更改。

注解

Set_Fill替代由Initialize_Conversation或Accept_Conversation建立的默认填充。 默认 填充 为CM_FILL_LL。

填充值会影响所有后续的 Receive 调用。 可以通过重新发出 Set_Fill 调用来更改它。