Fungsi OpenEncryptedFileRawA (winbase.h)

Artikel
08/27/2023

Membuka file terenkripsi untuk mencadangkan (mengekspor) atau memulihkan (mengimpor) file. 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 OpenEncryptedFileRawA(
  [in]  LPCSTR lpFileName,
  [in]  ULONG  ulFlags,
  [out] PVOID  *pvContext
);

Parameter

[in] lpFileName

Nama file yang akan dibuka. String harus terdiri dari karakter dari set karakter Windows.

[in] ulFlags

Operasi yang akan dilakukan. Parameter ini mungkin salah satu nilai berikut.

Nilai	Makna
0	Buka file untuk ekspor (cadangan).
CREATE_FOR_IMPORT 1	File sedang dibuka untuk diimpor (pemulihan).
CREATE_FOR_DIR 2	Impor (pulihkan) direktori yang berisi file terenkripsi. Ini harus dikombinasikan dengan salah satu dari dua bendera sebelumnya untuk menunjukkan operasi.
OVERWRITE_HIDDEN 4	Timpa file tersembunyi saat mengimpor.

[out] pvContext

Alamat blok konteks yang harus disajikan dalam panggilan berikutnya ke ReadEncryptedFileRaw, WriteEncryptedFileRaw, atau CloseEncryptedFileRaw. Jangan ubah.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan 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

Pemanggil harus memiliki akses baca atau tulis ke file, atau harus memiliki hak istimewa cadangan SeBackupPrivilege pada komputer tempat file berada agar panggilan berhasil.

Untuk mencadangkan file terenkripsi, panggil OpenEncryptedFileRaw untuk membuka file lalu panggil ReadEncryptedFileRaw. Setelah pencadangan selesai, hubungi CloseEncryptedFileRaw.

Untuk memulihkan file terenkripsi, panggil OpenEncryptedFileRaw, menentukan CREATE_FOR_IMPORT dalam parameter ulFlags , lalu panggil WriteEncryptedFileRaw sekali. Ketika operasi selesai, panggil CloseEncryptedFileRaw.

OpenEncryptedFileRaw gagal jika lpFileName melebihi MAX_PATH karakter saat membuka file terenkripsi pada komputer jarak jauh.

Jika penelepon tidak memiliki akses ke kunci untuk file, pemanggil memerlukan SeBackupPrivilege untuk mengekspor file terenkripsi atau SeRestorePrivilege untuk mengimpor file terenkripsi.

Fungsi BackupRead dan BackupWrite menangani pencadangan dan pemulihan 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.

Catatan

Header winbase.h mendefinisikan OpenEncryptedFileRaw sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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)