共用方式為

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傳回。

填補
提供的 參數。 指定程式將接收資料的表單。 下面是一些可能的選項：

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