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_ConversationAccept_Conversation返回。

填补
提供的参数。 指定程序将接收数据的窗体。 以下是可能的选择:

CM_FILL_BUFFER
本地程序接收数据,直到到达接收调用的 requested_length 参数指定的字节数或数据结束为止。 无论逻辑记录格式如何,都会收到数据。

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

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

返回代码

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

CM_PROGRAM_PARAMETER_CHECK
主要返回代码;发生以下事件之一:

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

  • 映射当前对话。

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

状态更改

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

没有状态更改。

注解

Set_Fill替代由Initialize_ConversationAccept_Conversation建立的默认填充。 默认 填充 为CM_FILL_LL。

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