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 所傳回。
填補
提供的參數。 指定程式將接收資料的表單。 以下是可能的選擇:
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_Conversation或Accept_Conversation所建立的預設填滿。 默認 填滿 是CM_FILL_LL。
填滿值會影響所有後續的接收呼叫。 您可以重新發出 Set_Fill 呼叫來變更它。