Bagikan melalui


Fungsi DecryptFileA (winbase.h)

Mendekripsi file atau direktori terenkripsi.

Sintaks

BOOL DecryptFileA(
  [in] LPCSTR lpFileName,
       DWORD  dwReserved
);

Parameter

[in] lpFileName

Nama file atau direktori yang akan didekripsi.

Pemanggil harus memiliki hak akses FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES, dan SYNCHRONIZE . Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.

dwReserved

Dipesan; harus nol.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi DecryptFile memerlukan akses eksklusif ke file yang didekripsi, dan akan gagal jika proses lain menggunakan file . Jika file tidak dienkripsi, DecryptFile hanya mengembalikan nilai bukan nol, yang menunjukkan keberhasilan.

Jika lpFileName menentukan file baca-saja, fungsi gagal dan GetLastError mengembalikan ERROR_FILE_READ_ONLY. Jika lpFileName menentukan direktori yang berisi file baca-saja, fungsi berhasil tetapi direktori tidak didekripsi.

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 DecryptFile 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

   
Klien minimum yang didukung Windows XP [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)

Lihat juga

CreateFile

EncryptFile

Enkripsi File

Fungsi Manajemen File