Fungsi FCICreate (fci.h)

Artikel
08/23/2023

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.