DecryptFileA, fonction (winbase.h)

Déchiffre un fichier ou un répertoire chiffré.

Syntaxe

BOOL DecryptFileA(
  [in] LPCSTR lpFileName,
       DWORD  dwReserved
);

Paramètres

[in] lpFileName

Nom du fichier ou du répertoire à déchiffrer.

L’appelant doit disposer des droits d’accès FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTES et SYNCHRONIZE . Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.

dwReserved

Réservés au; doit être égal à zéro.

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

La fonction DecryptFile nécessite un accès exclusif au fichier en cours de déchiffrement et échoue si un autre processus utilise le fichier. Si le fichier n’est pas chiffré, DecryptFile retourne simplement une valeur différente de zéro, ce qui indique la réussite.

Si lpFileName spécifie un fichier en lecture seule, la fonction échoue et GetLastError retourne ERROR_FILE_READ_ONLY. Si lpFileName spécifie un répertoire qui contient un fichier en lecture seule, les fonctions réussissent, mais le répertoire n’est pas déchiffré.

Dans Windows 8, Windows Server 2012 et versions ultérieures, 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)	Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Non
Système de fichiers du volume partagé de cluster (CsvFS)	No
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.

Notes

L’en-tête winbase.h définit DecryptFile en tant qu’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. La combinaison 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.

Configuration requise

Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll
Ensemble d’API	ext-ms-win-advapi32-encryptedfile-l1-1-0 (introduit dans Windows 8)

Voir aussi

CreateFile

EncryptFile

Chiffrement de fichiers

Fonctions de gestion des fichiers