Fungsi WriteEncryptedFileRaw (winbase.h)

Artikel
03/08/2023

Memulihkan (mengimpor) 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 WriteEncryptedFileRaw(
  [in]           PFE_IMPORT_FUNC pfImportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Parameter

[in] pfImportCallback

Penunjuk ke fungsi panggilan balik impor. Sistem memanggil fungsi panggilan balik beberapa kali, setiap kali melewati buffer yang akan diisi oleh fungsi panggilan balik dengan sebagian data file yang dicadangkan. Ketika fungsi panggilan balik menandakan bahwa seluruh file telah diproses, ia memberi tahu sistem bahwa operasi pemulihan selesai. Untuk informasi selengkapnya, lihat ImportCallback.

[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 dipulihkan tidak didekripsi; dipulihkan 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 ekspor.

Jika file adalah file jarang yang dicadangkan dari volume dengan ukuran unit alokasi jarang yang lebih kecil daripada volume yang sedang dipulihkan, blok jarang di tengah file mungkin tidak selaras dengan blok yang lebih besar dan panggilan fungsi akan gagal dan mengatur kode kesalahan terakhir ERROR_INVALID_PARAMETER . Ukuran unit alokasi jarang adalah 16 kluster atau 64 KB, mana yang lebih kecil.

Fungsi ini ditujukan untuk memulihkan hanya file terenkripsi; lihat BackupWrite untuk memulihkan 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


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 di Windows 8)