PFE_EXPORT_FUNC fonction de rappel (winbase.h)

Article
08/27/2023

Fonction de rappel définie par l’application utilisée avec ReadEncryptedFileRaw. Le système appelle ExportCallback une ou plusieurs fois, à chaque fois avec un bloc des données du fichier chiffré, jusqu’à ce qu’il ait reçu toutes les données du fichier. ExportCallback écrit les données du fichier chiffré dans un autre support de stockage, généralement à des fins de sauvegarde du fichier.

Le type PFE_EXPORT_FUNC définit un pointeur vers la fonction de rappel. ExportCallback est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

PFE_EXPORT_FUNC PfeExportFunc;

DWORD PfeExportFunc(
  [in]           PBYTE pbData,
  [in, optional] PVOID pvCallbackContext,
  [in]           ULONG ulLength
)
{...}

Paramètres

[in] pbData

Pointeur vers un bloc des données du fichier chiffré à sauvegarder. Ce bloc de données est alloué par le système.

[in, optional] pvCallbackContext

Pointeur vers un bloc de contexte défini par l’application et alloué. L’application transmet ce pointeur à ReadEncryptedFileRaw, et ReadEncryptedFileRaw transmet ce pointeur à la fonction de rappel afin qu’elle puisse accéder aux données spécifiques de l’application. Ces données peuvent être une structure et contenir toutes les données dont l’application a besoin, telles que le handle du fichier qui contient la copie de sauvegarde du fichier chiffré.

[in] ulLength

Taille des données pointées vers le paramètre pbData , en octets.

Valeur retournée

Si la fonction réussit, elle doit définir la valeur de retour sur ERROR_SUCCESS.

Si la fonction échoue, définissez la valeur de retour sur un code d’erreur différent de zéro défini dans WinError.h. Par exemple, si cette fonction échoue parce qu’une API qu’elle appelle échoue, vous pouvez définir la valeur de retour sur la valeur retournée par GetLastError pour l’API ayant échoué.

Remarques

Vous pouvez utiliser le bloc de contexte défini par l’application pour le suivi interne d’informations telles que le handle de fichier et le décalage actuel dans le fichier.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [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)