Fungsi ReadEncryptedFileRaw (winbase.h)
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) |