Fungsi OpenEncryptedFileRawA (winbase.h)

Membuka file terenkripsi untuk mencadangkan (ekspor) 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 mereka.

Sintaksis

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	Arti
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.

Mengembalikan nilai

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.

Komentar

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, panggil 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 karakter MAX_PATH saat membuka file terenkripsi pada komputer jarak jauh.

Jika pemanggil 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
Failover Transparan (TFO) SMB 3.0	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.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows XP Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	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)

Lihat juga

BackupRead

BackupWrite

CloseEncryptedFileRaw

Enkripsi File

File Management Functions

ReadEncryptedFileRaw

WriteEncryptedFileRaw