OpenEncryptedFileRawA, fonction (winbase.h)

Article
11/20/2024

Ouvre un fichier chiffré pour sauvegarder (exporter) ou restaurer (importer) le fichier. 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 à exporter (sauvegarde).
CREATE_FOR_IMPORT 1	Le fichier est ouvert pour l’importation (restauration).
CREATE_FOR_DIR 2	Importez (restaurez) un répertoire contenant des fichiers chiffrés. Cette opération doit être combinée avec 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 de retour

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 de FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description de texte générique de l’erreur.

Remarques

L’appelant doit avoir 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 se trouvent les fichiers afin 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 WriteEncryptedFileRaw une seule fois. Une fois l’opération terminée, appelez CloseEncryptedFileRaw.

OpenEncryptedFileRaw échoue si lpFileName dépasse les caractères MAX_PATH lors de l’ouverture d’un fichier chiffré sur un ordinateur distant.

Si l’appelant n’a pas accès à la clé du fichier, l’appelant a besoin de SeBackupPrivilege pour exporter des fichiers chiffrés ou SeRestorePrivilege pour importer des fichiers chiffrés.

Les fonctions BackupRead et BackupWrite gèrent la sauvegarde et la restauration de 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	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 OpenEncryptedFileRaw 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)