ReadEncryptedFileRaw, fonction (winbase.h)

Article
08/27/2023

Sauvegarde (exportation) des 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 ReadEncryptedFileRaw(
  [in]           PFE_EXPORT_FUNC pfExportCallback,
  [in, optional] PVOID           pvCallbackContext,
  [in]           PVOID           pvContext
);

Paramètres

[in] pfExportCallback

Pointeur vers la fonction de rappel d’exportation. Le système appelle la fonction de rappel plusieurs fois, passant chaque fois un bloc des données du fichier à la fonction de rappel jusqu’à ce que le fichier entier ait été lu. Pour plus d’informations, consultez ExportCallback.

[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 sauvegarde n’est pas déchiffré ; il est sauvegardé 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’importation, consultez ImportCallback .

Cette fonction est destinée à la sauvegarde des fichiers chiffrés uniquement ; consultez BackupRead pour la sauvegarde 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.

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)