Función de devolución de llamada PFNCryptStreamOutputCallback (ncryptprotect.h)

  • Artículo

La función PFNCryptStreamOutputCallback recibe datos cifrados o descifrados de las tareas iniciadas mediante las funciones NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect . Esta devolución de llamada debe definirse mediante la aplicación mediante la sintaxis siguiente.

Sintaxis

PFNCryptStreamOutputCallback Pfncryptstreamoutputcallback;

SECURITY_STATUS Pfncryptstreamoutputcallback(
  [in] void *pvCallbackCtxt,
  [in] const BYTE *pbData,
       SIZE_T cbData,
       BOOL fFinal
)
{...}

Parámetros

[in] pvCallbackCtxt

Puntero a los datos que puede usar para realizar un seguimiento de la aplicación. La API de protección de datos no modifica los datos.

Nota Puede establecer un puntero a los datos de contexto en el miembro pvCallbackCtxt de la estructura NCRYPT_PROTECT_STREAM_INFO antes de pasar un puntero a esa estructura en el parámetro pStreamInfo de las funciones NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect .
 

[in] pbData

Puntero a un bloque de datos procesados que la aplicación puede usar.

cbData

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

fFinal

Si este valor es TRUE, el bloque de datos actual es el último que se va a procesar y esta es la última vez que se llamará a la devolución de llamada.

Valor devuelto

Si devuelve algún código de estado distinto de ERROR_SUCCESS de la implementación de esta función de devolución de llamada, se producirá un error en el proceso de cifrado o descifrado de secuencia.

Código devuelto Descripción
ERROR_SUCCESS
 La función se realizó correctamente.

Comentarios

Establezca un puntero a esta función de devolución de llamada en el miembro pfnStreamOutput de la estructura NCRYPT_PROTECT_STREAM_INFO . Establezca un puntero a la estructura en el parámetro pStreamInfo de las funciones NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect .

Puede usar esta devolución de llamada para procesar aún más los datos cifrados o descifrados. Un uso común de la función es escribir los datos en el disco a medida que se reciben de la API de protección de datos. Los bloques de datos cifrados o sin cifrar se crean mediante la función NCryptStreamUpdate .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ncryptprotect.h

Consulte también

Funciones de DPAPI de CNG

NCRYPT_PROTECT_STREAM_INFO

NCryptStreamOpenToProtect

NCryptStreamOpenToUnprotect

NCryptStreamUpdate