共用方式為

Flush (CPI-C)

  • 發行項

Flush呼叫 (函式名稱cmflus) 會將本機邏輯單元 (LU) 傳送緩衝區的內容傳送至夥伴 LU (和程式) 。 如果傳送緩衝區是空的，則不會採取任何動作。

語法

  
CM_ENTRY Flush(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *return_code              
);

參數

conversation_ID
提供的 參數。 指定交談的識別碼。 此參數的值是由 Initialize_Conversation 或 Accept_Conversation傳回。

return_code
從這個呼叫傳回的程式碼。 本主題稍後會列出有效的傳回碼。

傳回碼

CM_OK
主要傳回碼;已成功執行呼叫。

CM_OPERATION_NOT_ACCEPTED
主要傳回碼;此交談的上一個作業不完整。

CM_OPERATION_INCOMPLETE
主要傳回碼;作業尚未完成 (處理模式只會) 封鎖且仍在進行中。 程式可以發出 Wait_For_Conversation 以等候作業完成，或 Cancel_Conversation 取消作業和交談。 如果已呼叫 Specify_Windows_Handle ，應用程式應該等候 Microsoft® Windows® 訊息通知，而不是呼叫 Wait_For_Conversation。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_ID 指定的值無效。

CM_PROGRAM_STATE_CHECK
主要傳回碼;當程式發出此呼叫時，交談並未處於 SEND 或SEND_PENDING狀態。

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

狀態變更

交談必須處於 SEND 或SEND_PENDING狀態。

如果呼叫順利完成， (return_code CM_OK) ，則交談處於 SEND 狀態。

其他傳回碼不會產生任何狀態變更。

備註

Send_Data處理的資料會累積在本機 LU 傳送緩衝區中，直到發生下列其中一項：

  • 本機程式會發出 Flush 呼叫或其他排清 LUS 傳送緩衝區的呼叫。 (某些傳送類型，由 Set_Send_Type設定，包括 flush 功能。)

  • 緩衝區已滿。

    配置要求所產生的 配置 要求，也會緩衝 處理Send_Error 所產生的錯誤資訊。