Fonction EncryptFileA (winbase.h)
Chiffre un fichier ou un répertoire. Tous les flux de données d’un fichier sont chiffrés. Tous les nouveaux fichiers créés dans un répertoire chiffré sont chiffrés.
Syntaxe
BOOL EncryptFileA(
[in] LPCSTR lpFileName
);
Paramètres
[in] lpFileName
Nom du fichier ou du répertoire à chiffrer.
L’appelant doit disposer des droits d’accès FILE_READ_DATA, FILE_WRITE_DATA, FILE_READ_ATTRIBUTES, FILE_WRITE_ATTRIBUTESet SYNCHRONIZE. Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.
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
La fonction EncryptFile nécessite un accès exclusif au fichier chiffré et échouera si un autre processus utilise le fichier.
Si le fichier est déjà chiffré, EncryptFile retourne simplement une valeur différente de zéro, ce qui indique la réussite. Si le fichier est compressé, EncryptFile décompresse le fichier avant de le chiffrer.
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 chiffré.
Pour déchiffrer un fichier chiffré, utilisez la fonction DecryptFile.
Dans Windows 8, Windows Server 2012 et versions ultérieures, 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 EncryptFile 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 |
| ensemble d’API | ext-ms-win-advapi32-encryptedfile-l1-1-0 (introduit dans Windows 8) |