PFN_CRYPT_XML_DATA_PROVIDER_READ función de devolución de llamada (cryptxml.h)

  • Artículo

La función de devolución de llamada PFN_CRYPT_XML_DATA_PROVIDER_READ lee datos XML.

Sintaxis

PFN_CRYPT_XML_DATA_PROVIDER_READ PfnCryptXmlDataProviderRead;

HRESULT PfnCryptXmlDataProviderRead(
  [in, out] void *pvCallbackState,
  [out]     BYTE *pbData,
  [in]      ULONG cbData,
  [out]     ULONG *pcbRead
)
{...}

Parámetros

[in, out] pvCallbackState

Puntero a un argumento definido por la aplicación que se pasa a la función que realiza la llamada.

[out] pbData

Puntero al búfer que recibe los datos que se van a leer.

[in] cbData

Tamaño, en bytes, de los datos que se van a leer.

[out] pcbRead

Puntero a una variable que recibe el número de bytes leídos realmente.

Valor devuelto

La función de devolución de llamada PFN_CRYPT_XML_DATA_PROVIDER_READ devuelve un valor cuando se produce una de las condiciones siguientes:

  • Una operación de escritura se completa en el proveedor de datos.
  • Se lee el número de bytes solicitados.
  • Se produce un error
Si la función se realiza correctamente, la función devuelve NO_ERROR.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error.

Si el valor de pcbRead es igual a cero, no hay más datos disponibles.

Comentarios

La función de devolución de llamada no devuelve un valor a menos que el número de bytes especificado en cbData esté disponible o se haya leído el último bloque de datos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado cryptxml.h