FCIFlushCabinet 函式 (fci.h)
FCIFlushCabinet 函式會完成目前的封包。
語法
BOOL DIAMONDAPI FCIFlushCabinet(
[in] HFCI hfci,
[in] BOOL fGetNextCab,
[in] PFNFCIGETNEXTCABINET pfnfcignc,
[in] PFNFCISTATUS pfnfcis
);
參數
[in] hfci
FCICreate 函式傳回的有效FCI內容句柄。
[in] fGetNextCab
指定是否要呼叫所提供 GetNextCab 參數所指向的函式。
[in] pfnfcignc
應用程式定義回呼函式的指標，以取得下一個要建立的封包規格。 函式應該使用 FNFCIGETNEXTCABINET 宏來宣告。
[in] pfnfcis
應用程式定義回呼函式的指標，以更新使用者。 函式應該使用 FNFCISTATUS 宏來宣告。
傳回值
如果函式成功，則會傳回 TRUE;否則為 FALSE。
擴充錯誤資訊是在用來建立FCI內容的 ERF 結構中提供。
備註
FCIFlushCabinet API 會強制立即完成目前的封包，然後寫入磁碟。 進一步呼叫 FCIAddFile 會導致檔案新增至另一個封包。
如果目前的封包已達到應用程式指定的媒體大小限制，FCI 內部緩衝區內的擱置數據將會放在另一個封包中。
fGetNextCab 旗標會判斷是否會呼叫 GetNextCab 參數所指向的函式。 如果 fGetNextCab 設定 為 TRUE， 則會呼叫 GetNextCab 以取得接續資訊。 如果 為 FALSE，則只有在封包溢位時才會呼叫 GetNextCab 。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | fci.h |
| 程式庫 | Cabinet.lib |
| Dll | Cabinet.dll |