Fungsi FCIFlushCabinet (fci.h)

Fungsi FCIFlushCabinet menyelesaikan kabinet saat ini.

Sintaks

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

Parameter

[in] hfci

Handel konteks FCI yang valid yang dikembalikan oleh fungsiFCICreate .

[in] fGetNextCab

Menentukan apakah fungsi yang ditunjukkan oleh parameter GetNextCab yang disediakan akan dipanggil.

[in] pfnfcignc

Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk mendapatkan spesifikasi pada kabinet berikutnya untuk dibuat. Fungsi harus dideklarasikan menggunakan makro FNFCIGETNEXTCABINET .

[in] pfnfcis

Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk memperbarui pengguna. Fungsi harus dideklarasikan menggunakan makro FNFCISTATUS .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TRUE; jika tidak, FALSE.

Informasi kesalahan yang diperluas disediakan dalam struktur ERF yang digunakan untuk membuat konteks FCI.

Keterangan

API FCIFlushCabinet memaksa kabinet saat ini sedang dibangun untuk segera diselesaikan dan kemudian ditulis ke disk. Panggilan lebih lanjut ke FCIAddFile akan mengakibatkan file ditambahkan ke kabinet lain.

Jika kabinet saat ini telah mencapai batas ukuran media yang ditentukan aplikasi, data yang tertunda dalam buffer internal FCI akan ditempatkan ke dalam kabinet lain.

Bendera fGetNextCab menentukan apakah fungsi yang ditunjukkan oleh parameter GetNextCab akan dipanggil. Jika fGetNextCab diatur TRUE, GetNextCab dipanggil untuk mendapatkan informasi kelanjutan. Jika FALSE, maka GetNextCab hanya dipanggil jika kabinet meluap.

Persyaratan

Lihat juga

FCIFlushFolder