Fungsi FileEncryptionStatusA (winbase.h)

Artikel
03/13/2024

Mengambil status enkripsi dari file yang ditentukan.

Sintaks

BOOL FileEncryptionStatusA(
  [in]  LPCSTR  lpFileName,
  [out] LPDWORD lpStatus
);

Parameter

[in] lpFileName

Nama file.

[out] lpStatus

Penunjuk ke variabel yang menerima status enkripsi file. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
FILE_ENCRYPTABLE 0	File dapat dienkripsi. Home, Home Premium, Starter, dan ARM Editions of Windows: FILE_ENCRYPTABLE dapat dikembalikan tetapi EFS tidak mendukung enkripsi file pada edisi Windows ini.
FILE_IS_ENCRYPTED 1	File dienkripsi.
FILE_READ_ONLY 8	File adalah file baca-saja.
FILE_ROOT_DIR 3	File adalah direktori akar. Direktori akar tidak dapat dienkripsi.
FILE_SYSTEM_ATTR 2	File adalah file sistem. File sistem tidak dapat dienkripsi.
FILE_SYSTEM_DIR 4	File adalah direktori sistem. Direktori sistem tidak dapat dienkripsi.
FILE_SYSTEM_NOT_SUPPORT 6	Sistem file tidak mendukung enkripsi file.
FILE_UNKNOWN 5	Status enkripsi tidak diketahui. File dapat dienkripsi.
FILE_USER_DISALLOWED 7	Disiapkan untuk penggunaan masa mendatang.

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

Di Windows 8 dan Windows Server 2012, 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 FileEncryptionStatus sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Lihat juga

EncryptFile

Enkripsi File

Fungsi Manajemen File

Share via