ReadEncryptedFileRaw, fonction (winbase.h)
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) |