FileEncryptionStatusA, fonction (winbase.h)

Article
11/20/2024

Récupère l’état de chiffrement du fichier spécifié.

Syntaxe

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

Paramètres

[in] lpFileName

Nom du fichier.

[out] lpStatus

Pointeur vers une variable qui reçoit l’état de chiffrement du fichier. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
FILE_ENCRYPTABLE 0	Le fichier peut être chiffré. Éditions Famille, Famille Premium, Starter et ARM de Windows : FILE_ENCRYPTABLE peut être retourné, mais EFS ne prend pas en charge le chiffrement des fichiers sur ces éditions de Windows.
FILE_IS_ENCRYPTED 1	Le fichier est chiffré.
FILE_READ_ONLY 8	Le fichier est un fichier en lecture seule.
FILE_ROOT_DIR 3	Le fichier est un répertoire racine. Les répertoires racines ne peuvent pas être chiffrés.
FILE_SYSTEM_ATTR 2	Le fichier est un fichier système. Les fichiers système ne peuvent pas être chiffrés.
FILE_SYSTEM_DIR 4	Le fichier est un répertoire système. Les répertoires système ne peuvent pas être chiffrés.
FILE_SYSTEM_NOT_SUPPORT 6	Le système de fichiers ne prend pas en charge le chiffrement des fichiers.
FILE_UNKNOWN 5	L’état du chiffrement est inconnu. Le fichier peut être chiffré.
FILE_USER_DISALLOWED 7	Réservé pour une utilisation ultérieure.

Valeur de retour

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’erreur étendues, appelez GetLastError.

Remarques

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

Technologie	Supporté
Protocole SMB (Server Message Block) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Non
Cluster Shared Volume File System (CsvFS)	Non
Système de fichiers résilient (ReFS)	Non

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

Note

L’en-tête winbase.h définit FileEncryptionStatus comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winbase.h (inclure Windows.h)
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

encryptFile

de chiffrement de fichiers

fonctions de gestion de fichiers

Partager via