PFE_EXPORT_FUNC función de devolución de llamada (winbase.h)

Artículo
03/09/2024

Función de devolución de llamada definida por la aplicación que se usa con ReadEncryptedFileRaw. El sistema llama a ExportCallback una o varias veces, cada vez con un bloque de los datos del archivo cifrado, hasta que haya recibido todos los datos del archivo. ExportCallback escribe los datos del archivo cifrado en otro medio de almacenamiento, normalmente con fines de copia de seguridad del archivo.

El tipo PFE_EXPORT_FUNC define un puntero a la función de devolución de llamada. ExportCallback es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

PFE_EXPORT_FUNC PfeExportFunc;

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

Parámetros

[in] pbData

Puntero a un bloque de los datos del archivo cifrado de los que se va a realizar una copia de seguridad. El sistema asigna este bloque de datos.

[in, optional] pvCallbackContext

Puntero a un bloque de contexto definido por la aplicación y asignado. La aplicación pasa este puntero a ReadEncryptedFileRaw y ReadEncryptedFileRaw pasa este puntero a la función de devolución de llamada para que pueda tener acceso a datos específicos de la aplicación. Estos datos pueden ser una estructura y pueden contener los datos que necesita la aplicación, como el identificador del archivo que contiene la copia de seguridad del archivo cifrado.

[in] ulLength

Tamaño de los datos a los que apunta el parámetro pbData , en bytes.

Valor devuelto

Si la función se ejecuta correctamente, debe establecer el valor devuelto en ERROR_SUCCESS.

Si se produce un error en la función, establezca el valor devuelto en un código de error distinto de cero definido en WinError.h. Por ejemplo, si se produce un error en esta función porque se produce un error en una API a la que llama, puede establecer el valor devuelto por GetLastError para la API con errores.

Comentarios

Puede usar el bloque de contexto definido por la aplicación para el seguimiento interno de información, como el identificador de archivo y el desplazamiento actual en el archivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluya Windows.h)