Fungsi FileEncryptionStatusA (winbase.h)

Mengambil status enkripsi dari file yang ditentukan.

Sintaksis

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	Arti
FILE_ENCRYPTABLE 0	File dapat dienkripsi. Home, Home Premium, Starter, dan ARM Editions 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 mungkin dienkripsi.
FILE_USER_DISALLOWED 7	Dicadangkan untuk digunakan di masa mendatang.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

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

Komentar

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

Lihat juga

EncryptFile

Enkripsi File

File Management Functions