共用方式為


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 呼叫來變更它。