Fungsi EncryptFileA (winbase.h)
Mengenkripsi file atau direktori. Semua aliran data dalam file dienkripsi. Semua file baru yang dibuat dalam direktori terenkripsi dienkripsi.
Sintaks
BOOL EncryptFileA(
[in] LPCSTR lpFileName
);
Parameter
[in] lpFileName
Nama file atau direktori yang akan dienkripsi.
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.
Nilai kembali
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 EncryptFile memerlukan akses eksklusif ke file yang sedang dienkripsi, dan akan gagal jika proses lain menggunakan file.
Jika file sudah dienkripsi, EncryptFile hanya mengembalikan nilai bukan nol, yang menunjukkan keberhasilan. Jika file dikompresi, EncryptFile akan mendekompresi file sebelum mengenkripsinya.
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 dienkripsi.
Untuk mendekripsi file terenkripsi, gunakan fungsi DecryptFile .
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 Berbagi File Peluasan Skala (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 EncryptFile 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) |