Fungsi ReadEncryptedFileRaw (winbase.h)

Artikel
03/08/2023

Mencadangkan (mengekspor) file terenkripsi. Ini adalah salah satu grup fungsi Sistem File Terenkripsi (EFS) yang dimaksudkan untuk menerapkan fungsionalitas pencadangan dan pemulihan, sambil mempertahankan file dalam status terenkripsi.

Sintaks

DWORD ReadEncryptedFileRaw(
  [in]           PFE_EXPORT_FUNC pfExportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Parameter

[in] pfExportCallback

Penunjuk ke fungsi panggilan balik ekspor. Sistem memanggil fungsi panggilan balik beberapa kali, setiap kali meneruskan blok data file ke fungsi panggilan balik hingga seluruh file dibaca. Untuk informasi selengkapnya, lihat ExportCallback.

[in, optional] pvCallbackContext

Penunjuk ke blok konteks yang ditentukan aplikasi dan dialokasikan. Sistem meneruskan pointer ini ke fungsi panggilan balik sebagai parameter sehingga fungsi panggilan balik dapat memiliki akses ke data khusus aplikasi. Ini bisa menjadi struktur dan dapat berisi data apa pun yang dibutuhkan aplikasi, seperti handel ke file yang akan berisi salinan cadangan file terenkripsi.

[in] pvContext

Penunjuk ke blok konteks yang ditentukan sistem. Blok konteks dikembalikan oleh fungsi OpenEncryptedFileRaw . Jangan ubah.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, fungsi mengembalikan kode kesalahan bukan nol yang ditentukan dalam WinError.h. Anda dapat menggunakan FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi teks umum tentang kesalahan tersebut.

Keterangan

File yang sedang dicadangkan tidak didekripsi; dicadangkan dalam status terenkripsi.

Untuk mencadangkan file terenkripsi, panggil OpenEncryptedFileRaw untuk membuka file. Kemudian panggil ReadEncryptedFileRaw, berikan alamat fungsi panggilan balik ekspor yang ditentukan aplikasi. Sistem memanggil fungsi panggilan balik ini beberapa kali sampai seluruh isi file telah dibaca dan dicadangkan. Ketika pencadangan selesai, panggil CloseEncryptedFileRaw untuk membebaskan sumber daya dan menutup file. Lihat ExportCallback untuk detail tentang cara mendeklarasikan fungsi panggilan balik ekspor.

Untuk memulihkan file terenkripsi, panggil OpenEncryptedFileRaw, yang menentukan CREATE_FOR_IMPORT dalam parameter ulFlags . Kemudian panggil WriteEncryptedFileRaw, berikan alamat fungsi panggilan balik impor yang ditentukan aplikasi. Sistem memanggil fungsi panggilan balik ini beberapa kali sampai seluruh isi file telah dibaca dan dipulihkan. Setelah pemulihan selesai, panggil CloseEncryptedFileRaw untuk membebaskan sumber daya dan menutup file. Lihat ImportCallback untuk detail tentang cara mendeklarasikan fungsi panggilan balik impor.

Fungsi ini ditujukan untuk pencadangan hanya file terenkripsi; lihat BackupRead untuk pencadangan file yang tidak terenkripsi.

Di Windows 8, Windows Server 2012, dan yang lebih baru, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Tidak
SMB 3.0 dengan Scale-out File Shares (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Tidak
Sistem File Tangguh (ReFS)	Tidak

SMB 3.0 tidak mendukung EFS pada berbagi dengan kemampuan ketersediaan berkelanjutan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll
Set API	ext-ms-win-advapi32-encryptedfile-l1-1-0 (diperkenalkan dalam Windows 8)