Fonction OpenEncryptedFileRawA (winbase.h)
Ouvre un fichier chiffré afin de le sauvegarder (exportation) ou de le restaurer (importation). Il s’agit d’un groupe de fonctions EFS (Encrypted File System) destinées à implémenter des fonctionnalités de sauvegarde et de restauration, tout en conservant les fichiers dans leur état chiffré.
Syntaxe
DWORD OpenEncryptedFileRawA(
[in] LPCSTR lpFileName,
[in] ULONG ulFlags,
[out] PVOID *pvContext
);
Paramètres
[in] lpFileName
Nom du fichier à ouvrir. La chaîne doit se composer de caractères du jeu de caractères Windows.
[in] ulFlags
Opération à effectuer. Ce paramètre peut être l’une des valeurs suivantes.
[out] pvContext
Adresse d’un bloc de contexte qui doit être présenté dans les appels suivants à ReadEncryptedFileRaw, WriteEncryptedFileRaw ou CloseEncryptedFileRaw. Ne la modifiez pas.
Valeur retournée
Si la fonction réussit, elle retourne ERROR_SUCCESS.
Si la fonction échoue, elle retourne un code d’erreur différent de zéro défini dans WinError.h. Vous pouvez utiliser FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description textuelle générique de l’erreur.
Remarques
L’appelant doit disposer d’un accès en lecture ou en écriture au fichier, ou il doit disposer du privilège de sauvegarde SeBackupPrivilege sur l’ordinateur sur lequel résident les fichiers pour que l’appel réussisse.
Pour sauvegarder un fichier chiffré, appelez OpenEncryptedFileRaw pour ouvrir le fichier, puis appelez ReadEncryptedFileRaw. Une fois la sauvegarde terminée, appelez CloseEncryptedFileRaw.
Pour restaurer un fichier chiffré, appelez OpenEncryptedFileRaw, en spécifiant CREATE_FOR_IMPORT dans le paramètre ulFlags , puis appelez Une fois WriteEncryptedFileRaw . Une fois l’opération terminée, appelez CloseEncryptedFileRaw.
OpenEncryptedFileRaw échoue si lpFileName dépasse MAX_PATH caractères lors de l’ouverture d’un fichier chiffré sur une machine distante.
Si l’appelant n’a pas accès à la clé du fichier, il a besoin de SeBackupPrivilege pour exporter des fichiers chiffrés ou de SeRestorePrivilege pour importer des fichiers chiffrés.
Les fonctions BackupRead et BackupWrite gèrent la sauvegarde et la restauration des fichiers non chiffrés.
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) | 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) | 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 OpenEncryptedFileRaw comme un 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 | 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) |