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_IDfill指定的值無效。

  • 目前的交談已對應。

    CM_PRODUCT_SPECIFIC_ERROR
    主要傳回碼;發生產品特定的錯誤,並已記錄在 products 錯誤記錄檔中。

狀態變更

交談可以處於 [重設] 以外的任何狀態。

沒有狀態變更。

備註

Set_Fill覆寫Initialize_ConversationAccept_Conversation所建立的預設填滿。 預設 填滿 是 CM_FILL_LL。

填滿值會影響所有後續的接收呼叫。 您可以藉由重新發出 Set_Fill 呼叫來變更它。