Función CryptXmlDigestReference (cryptxml.h)

Una aplicación usa la función CryptXmlDigestReference para resumen la referencia resuelta. Esta función aplica transformaciones antes de actualizar el resumen.

Sintaxis

HRESULT CryptXmlDigestReference(
  [in] HCRYPTXML               hReference,
       DWORD                   dwFlags,
  [in] CRYPT_XML_DATA_PROVIDER *pDataProviderIn
);

Parámetros

[in] hReference

Identificador de un elemento Reference .

dwFlags

Especifica valores que controlan cómo aplica el proceso las transformaciones.

Los dwFlags definidos actualmente se muestran en la tabla siguiente.

Valor	Significado
CRYPT_XML_REFERENCE_DATA_TRANSFORMED 0x00000001	Especifica que el motor de procesamiento creará el resumen sin aplicar el motor de cadena de transformación.

[in] pDataProviderIn

Puntero a una estructura de CRYPT_XML_DATA_PROVIDER que especifica el proveedor de datos. La función CryptXmlDigestReference siempre llama a la función fpnClose en el proveedor de datos.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve cero.

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

Comentarios

Cuando se establece la marca CRYPT_XML_REFERENCE_DATA_TRANSFORMED , el motor de procesamiento agrega datos recibidos directamente al resumen sin aplicar el motor de cadena de transformación.

Nota La función CryptXmlDigestReference siempre llama a la función a la que apunta el miembro fpnClose de la estructura CRYPT_XML_DATA_PROVIDER a la que apunta el parámetro pDataProviderIn .

 

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
Library	Cryptxml.lib
Archivo DLL	Cryptxml.dll