Fonction WriteEncryptedFileRaw (winbase.h)

Article
08/27/2023

Restauration (importation) de fichiers chiffrés. 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 WriteEncryptedFileRaw(
  [in]           PFE_IMPORT_FUNC pfImportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Paramètres

[in] pfImportCallback

Pointeur vers la fonction de rappel d’importation. Le système appelle la fonction de rappel plusieurs fois, à chaque passage d’une mémoire tampon qui sera remplie par la fonction de rappel avec une partie des données du fichier sauvegardé. Lorsque la fonction de rappel signale que le fichier entier a été traité, elle indique au système que l’opération de restauration est terminée. Pour plus d’informations, consultez ImportCallback.

[in, optional] pvCallbackContext

Pointeur vers un bloc de contexte défini par l’application et alloué. Le système transmet ce pointeur à la fonction de rappel en tant que paramètre afin que la fonction de rappel puisse avoir accès aux données spécifiques de l’application. Il peut s’agir d’une structure et peut contenir toutes les données dont l’application a besoin, telles que le handle du fichier qui contiendra la copie de sauvegarde du fichier chiffré.

[in] pvContext

Pointeur vers un bloc de contexte défini par le système. Le bloc de contexte est retourné par la fonction OpenEncryptedFileRaw . Ne la modifiez pas.

Valeur retournée

Si la fonction réussit, la valeur de retour est 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

Le fichier en cours de restauration n’est pas déchiffré ; il est restauré dans son état chiffré.

Pour sauvegarder un fichier chiffré, appelez OpenEncryptedFileRaw pour ouvrir le fichier. Appelez ensuite ReadEncryptedFileRaw, en lui transmettant l’adresse d’une fonction de rappel d’exportation définie par l’application. Le système appelle cette fonction de rappel plusieurs fois jusqu’à ce que le contenu du fichier entier ait été lu et sauvegardé. Une fois la sauvegarde terminée, appelez CloseEncryptedFileRaw pour libérer des ressources et fermez le fichier. Pour plus d’informations sur la déclaration de la fonction de rappel d’exportation, consultez ExportCallback .

Pour restaurer un fichier chiffré, appelez OpenEncryptedFileRaw, en spécifiant CREATE_FOR_IMPORT dans le paramètre ulFlags . Ensuite, appelez WriteEncryptedFileRaw, en lui transmettant l’adresse d’une fonction de rappel d’importation définie par l’application. Le système appelle cette fonction de rappel plusieurs fois jusqu’à ce que le contenu du fichier entier ait été lu et restauré. Une fois la restauration terminée, appelez CloseEncryptedFileRaw pour libérer des ressources et fermez le fichier. Pour plus d’informations sur la déclaration de la fonction de rappel d’exportation, consultez ImportCallback .

Si le fichier est un fichier partiellement alloué qui a été sauvegardé à partir d’un volume avec une taille d’unité d’allocation éparse inférieure à celle du volume sur lequel il est restauré, les blocs éparses au milieu du fichier peuvent ne pas s’aligner correctement sur les blocs plus grands et l’appel de fonction échouerait et définirait un ERROR_INVALID_PARAMETER dernier code d’erreur. La taille de l’unité d’allocation éparse est de 16 clusters ou de 64 Ko, selon la taille la plus petite.

Cette fonction est destinée à restaurer uniquement les fichiers chiffrés ; consultez BackupWrite pour 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	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)	Non

SMB 3.0 ne prend pas en charge EFS sur les partages avec une fonctionnalité de disponibilité continue.

Configuration requise


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)