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.

Value Meaning
CRYPT_XML_REFERENCE_DATA_TRANSFORMED
0x00000001
Specifies that the processing engine will create the digest without applying the transform chain engine.

[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.

Note  The CryptXmlDigestReference function always calls the function pointed to by the fpnClose member of the CRYPT_XML_DATA_PROVIDER structure pointed to by the pDataProviderIn parameter.
 

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header cryptxml.h
Library Cryptxml.lib
DLL Cryptxml.dll