CryptXmlDigestReference function (cryptxml.h)

The CryptXmlDigestReference function is used by an application to digest the resolved reference. This function applies transforms before updating the digest.

Syntax

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

Parameters

[in] hReference

The handle of a Reference element.

dwFlags

Specifies values that control how the process applies transforms.

Currently defined dwFlags are shown in the following table.

[in] pDataProviderIn

A pointer to a CRYPT_XML_DATA_PROVIDER structure that specifies the data provider. The CryptXmlDigestReference function always calls the fpnClose function on the data provider.

Return value

If the function succeeds, the function returns zero.

If the function fails, it returns an HRESULT value that indicates the error.

Remarks

When the CRYPT_XML_REFERENCE_DATA_TRANSFORMED flag is set, the processing engine adds received data directly to the digest without applying the transform chain engine.

Requirements