PFE_EXPORT_FUNC función de devolución de llamada (winbase.h)
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) |