FCIFlushFolder 函式 (fci.h)

FCIFlushFolder函式會強制立即完成建構中的目前資料夾。

語法

BOOL DIAMONDAPI FCIFlushFolder(
  [in] HFCI                 hfci,
  [in] PFNFCIGETNEXTCABINET pfnfcignc,
  [in] PFNFCISTATUS         pfnfcis
);

[in] hfci

FCICreate函式傳回的有效 FCI 內容控制碼。

[in] pfnfcignc

應用程式定義回呼函式的指標，以取得下一個要建立之封包上的規格。函式應該使用 FNFCIGETNEXTCABINET 宏來宣告。

[in] pfnfcis

應用程式定義回呼函式的指標，以更新使用者。函式應該使用 FNFCISTATUS 宏來宣告。

如果函式成功，則會傳回 TRUE;否則為 FALSE。

擴充錯誤資訊是在用來建立 FCI 內容的 ERF 結構中提供。

FCIFlushFolder API 會強制目前正在建構的資料夾立即完成;如果壓縮方法正在使用中，則有效地重設壓縮歷程記錄。

如果封包溢位， 則會呼叫 GetNextCab 所指示的回呼函式，如果 FCI 內緩衝的暫止資料導致超過應用程式指定的封包媒體大小，就會發生此情況。