Fungsi EncryptionDisable (winefs.h)

Artikel
08/27/2023

Menonaktifkan atau mengaktifkan enkripsi direktori yang ditentukan dan file di dalamnya. Ini tidak memengaruhi enkripsi subdirektori di bawah direktori yang ditunjukkan.

Sintaks

BOOL EncryptionDisable(
  [in] LPCWSTR DirPath,
  [in] BOOL    Disable
);

Parameter

[in] DirPath

Nama direktori untuk mengaktifkan atau menonaktifkan enkripsi.

[in] Disable

Menunjukkan apakah akan menonaktifkan enkripsi (TRUE) atau mengaktifkannya (FALSE).

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

Dalam keadaan normal, EncryptFile tidak akan mengenkripsi file dan direktori dengan set atribut FILE_ATTRIBUTE_SYSTEM . Dimungkinkan untuk mengambil alih atribut FILE_ATTRIBUTE_SYSTEM dan mengenkripsi file. Selain itu, jika file atau direktori ditandai dengan atribut FILE_ATTRIBUTE_SYSTEM , biasanya tidak akan terlihat oleh pengguna dalam daftar direktori dan jendela direktori Windows Explorer. EncryptionDisable menonaktifkan enkripsi direktori dan file. Ini tidak memengaruhi visibilitas file dengan set atribut FILE_ATTRIBUTE_SYSTEM .

Jika TRUE diteruskan, EncryptionDisable akan menulis hal berikut ke file Desktop.ini di direktori (membuatnya jika perlu):

[Encryption]
Disable=1

Jika bagian sudah ada tetapi Nonaktifkan diatur ke 0, bagian tersebut akan diatur ke 1.

Setelah itu, EncryptFile akan gagal pada direktori dan file di dalamnya, dan kode yang dikembalikan GetLastError akan ERROR_DIR_EFS_DISALLOWED. Fungsi ini tidak memengaruhi enkripsi subdirektori dalam direktori yang diberikan.

Pengguna juga dapat menambahkan atau mengedit baris di atas secara manual dalam file Desktop.ini dan menghasilkan efek yang sama.

EncryptionDisable hanya memengaruhi FileEncryptionStatus dan EncryptFile. Setelah direktori dienkripsi, file baru dan subdirektori baru yang dibuat tanpa atribut FILE_ATTRIBUTE_SYSTEM akan dienkripsi.

Jika FALSE diteruskan, EncryptionDisable akan menulis hal berikut ke file Desktop.ini:

[Encryption]
Disable=0

Ini berarti bahwa enkripsi file diizinkan pada file di direktori tersebut.

Jika Anda mencoba menggunakan EncryptionDisable untuk mengatur direktori ke statusnya, fungsi berhasil tetapi tidak berpengaruh.

Jika Anda mencoba menggunakan EncryptionDisable untuk menonaktifkan atau mengaktifkan enkripsi pada file, upaya tersebut akan gagal.

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.

Persyaratan


Klien minimum yang didukung	Windows XP Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winefs.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll