Fungsi FCICreate (fci.h)
Fungsi FCICreate membuat konteks FCI.
Sintaks
HFCI DIAMONDAPI FCICreate(
[in, out] PERF perf,
[in] PFNFCIFILEPLACED pfnfcifp,
[in] PFNFCIALLOC pfna,
[in] PFNFCIFREE pfnf,
[in] PFNFCIOPEN pfnopen,
[in] PFNFCIREAD pfnread,
[in] PFNFCIWRITE pfnwrite,
[in] PFNFCICLOSE pfnclose,
[in] PFNFCISEEK pfnseek,
[in] PFNFCIDELETE pfndelete,
[in] PFNFCIGETTEMPFILE pfnfcigtf,
[in] PCCAB pccab,
[in, optional] void *pv
);
Parameter
[in, out] perf
Penunjuk ke struktur ERF yang menerima informasi kesalahan.
[in] pfnfcifp
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk memberi tahu saat file ditempatkan di kabinet. Fungsi harus dideklarasikan menggunakan makro FNFCIFILEPLACED .
[in] pfna
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk mengalokasikan memori. Fungsi harus dideklarasikan menggunakan makro FNFCIALLOC .
[in] pfnf
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk membebaskan memori yang dialokasikan sebelumnya. Fungsi harus dideklarasikan menggunakan makro FNFCIFREE .
[in] pfnopen
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk membuka file. Fungsi harus dideklarasikan menggunakan makro FNFCIOPEN .
[in] pfnread
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk membaca data dari file. Fungsi harus dideklarasikan menggunakan makro FNFCIREAD .
[in] pfnwrite
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk menulis data ke file. Fungsi harus dideklarasikan menggunakan makro FNFCIWRITE .
[in] pfnclose
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk menutup file. Fungsi harus dideklarasikan menggunakan makro FNFCICLOSE .
[in] pfnseek
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk memindahkan penunjuk file ke lokasi tertentu. Fungsi harus dideklarasikan menggunakan makro FNFCISEEK .
[in] pfndelete
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk menghapus file. Fungsi harus dideklarasikan menggunakan makro FNFCIDELETE .
[in] pfnfcigtf
Arahkan ke fungsi panggilan balik yang ditentukan aplikasi untuk mengambil nama file sementara. Fungsi harus dideklarasikan menggunakan makro FNFCIGETTEMPFILE .
[in] pccab
Penunjuk ke struktur CCAB yang berisi parameter untuk membuat kabinet.
[in, optional] pv
Penunjuk ke nilai yang ditentukan aplikasi yang diteruskan ke fungsi panggilan balik.
Menampilkan nilai
Jika fungsi berhasil, fungsi mengembalikan penunjuk konteks HFCI non-NULL ; jika tidak, NULL.
Informasi kesalahan yang diperluas disediakan dalam struktur ERF .
Keterangan
FCI mendukung beberapa konteks simultan. Akibatnya dimungkinkan untuk membuat atau mengekstrak beberapa lemari pada saat yang sama dalam aplikasi yang sama. Jika aplikasi multithreaded, dimungkinkan juga untuk menjalankan konteks yang berbeda di setiap utas; namun, aplikasi tidak dapat menggunakan konteks yang sama secara bersamaan dalam beberapa utas. Misalnya, FCIAddFile tidak dapat dipanggil dari dua utas yang berbeda, menggunakan konteks FCI yang sama.
Persyaratan
| Target Platform | Windows |
| Header | fci.h |
| Pustaka | Cabinet.lib |
| DLL | Cabinet.dll |