Fonction EncryptionDisable (winefs.h)

Article
08/27/2023

Désactive ou active le chiffrement du répertoire spécifié et des fichiers qu’il contient. Cela n’affecte pas le chiffrement des sous-répertoires situés sous le répertoire indiqué.

Syntaxe

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

Paramètres

[in] DirPath

Nom du répertoire pour lequel activer ou désactiver le chiffrement.

[in] Disable

Indique s’il faut désactiver le chiffrement (TRUE) ou l’activer (FALSE).

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Dans des circonstances normales, EncryptFile ne chiffre pas les fichiers et les répertoires avec l’attribut FILE_ATTRIBUTE_SYSTEM défini. Il est possible de remplacer l’attribut FILE_ATTRIBUTE_SYSTEM et de chiffrer les fichiers. En outre, si un fichier ou un répertoire est marqué avec l’attribut FILE_ATTRIBUTE_SYSTEM, il est normalement invisible pour l’utilisateur dans les listes de répertoires et windows Explorer fenêtres de répertoire. EncryptionDisable désactive le chiffrement des répertoires et des fichiers. Cela n’affecte pas la visibilité des fichiers dont l’attribut FILE_ATTRIBUTE_SYSTEM est défini.

Si TRUE est transmis, EncryptionDisable écrit ce qui suit dans le fichier Desktop.ini dans le répertoire (en le créant si nécessaire) :

[Encryption]
Disable=1

Si la section existe déjà, mais que Désactiver a la valeur 0, elle est définie sur 1.

Par la suite, EncryptFile échoue sur le répertoire et les fichiers qu’il contient, et le code retourné par GetLastError sera ERROR_DIR_EFS_DISALLOWED. Cette fonction n’affecte pas le chiffrement des sous-répertoires dans le répertoire donné.

L’utilisateur peut également ajouter ou modifier manuellement les lignes ci-dessus dans le fichier Desktop.ini et produire le même effet.

EncryptionDisable affecte uniquement FileEncryptionStatus et EncryptFile. Une fois le répertoire chiffré, tous les nouveaux fichiers et sous-répertoires créés sans l’attribut FILE_ATTRIBUTE_SYSTEM sont chiffrés.

Si FALSE est transmis, EncryptionDisable écrit ce qui suit dans le fichier Desktop.ini :

[Encryption]
Disable=0

Cela signifie que le chiffrement des fichiers est autorisé sur les fichiers de ce répertoire.

Si vous essayez d’utiliser EncryptionDisable pour définir le répertoire à l’état dans lequel il se trouve déjà, la fonction réussit mais n’a aucun effet.

Si vous essayez d’utiliser EncryptionDisable pour désactiver ou activer le chiffrement sur un fichier, la tentative échoue.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	No
Système de fichiers du volume partagé de cluster (CsvFS)	Non
Système de fichiers résilient (ReFS)	No

SMB 3.0 ne prend pas en charge EFS sur les partages avec une fonctionnalité de disponibilité continue.

Configuration requise


Client minimal pris en charge	Windows XP Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winefs.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll