Fonction OpenEncryptedFileRawA (winbase.h)

Article
08/27/2023

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.

Valeur	Signification
0	Ouvrez le fichier pour exportation (sauvegarde).
CREATE_FOR_IMPORT 1	Le fichier est en cours d’ouverture pour l’importation (restauration).
CREATE_FOR_DIR 2	Importer (restaurer) un répertoire contenant des fichiers chiffrés. Cela doit être combiné à l’un des deux indicateurs précédents pour indiquer l’opération.
OVERWRITE_HIDDEN 4	Remplacez un fichier masqué lors de l’importation.

[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)