PFE_EXPORT_FUNC fungsi panggilan balik (winbase.h)

Artikel
03/03/2024

Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan ReadEncryptedFileRaw. Sistem memanggil ExportCallback satu atau beberapa kali, setiap kali dengan blok data file terenkripsi, hingga menerima semua data file. ExportCallback menulis data file terenkripsi ke media penyimpanan lain, biasanya untuk tujuan mencadangkan file.

Jenis PFE_EXPORT_FUNC menentukan penunjuk ke fungsi panggilan balik. ExportCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PFE_EXPORT_FUNC PfeExportFunc;

DWORD PfeExportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in]           ULONG ulLength
)
{...}

Parameter

[in] pbData

Penunjuk ke blok data file terenkripsi yang akan dicadangkan. Blok data ini dialokasikan oleh sistem.

[in, optional] pvCallbackContext

Penunjuk ke blok konteks yang ditentukan aplikasi dan dialokasikan. Aplikasi meneruskan pointer ini ke ReadEncryptedFileRaw, dan ReadEncryptedFileRaw meneruskan penunjuk ini ke fungsi panggilan balik sehingga dapat memiliki akses ke data khusus aplikasi. Data ini dapat menjadi struktur dan dapat berisi data apa pun yang dibutuhkan aplikasi, seperti handel ke file yang berisi salinan cadangan file terenkripsi.

[in] ulLength

Ukuran data yang ditujukkan oleh parameter pbData , dalam byte.

Nilai kembali

Jika fungsi berhasil, fungsi harus mengatur nilai pengembalian ke ERROR_SUCCESS.

Jika fungsi gagal, atur nilai pengembalian ke kode kesalahan bukan nol yang ditentukan dalam WinError.h. Misalnya, jika fungsi ini gagal karena API yang dipanggilnya gagal, Anda dapat mengatur nilai pengembalian ke nilai yang dikembalikan oleh GetLastError untuk API yang gagal.

Keterangan

Anda dapat menggunakan blok konteks yang ditentukan aplikasi untuk pelacakan internal informasi seperti handel file dan offset saat ini dalam file.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)