CryptXmlDigestReference 函数 (cryptxml.h)

应用程序使用 CryptXmlDigestReference 函数来消化解析的引用。 此函数在更新摘要之前应用转换。

语法

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

参数

[in] hReference

Reference 元素的句柄。

dwFlags

指定控制过程如何应用转换的值。

下表显示了当前定义的 dwFlags

含义
CRYPT_XML_REFERENCE_DATA_TRANSFORMED
0x00000001
指定处理引擎将在不应用转换链引擎的情况下创建摘要。

[in] pDataProviderIn

指向指定数据提供程序 的CRYPT_XML_DATA_PROVIDER 结构的指针。 CryptXmlDigestReference 函数始终在数据提供程序上调用 fpnClose 函数。

返回值

如果函数成功,则函数返回零。

如果函数失败,它将返回一个 指示错误的 HRESULT 值。

注解

设置 CRYPT_XML_REFERENCE_DATA_TRANSFORMED 标志后,处理引擎会将接收的数据直接添加到摘要中,而无需应用转换链引擎。

注意CryptXmlDigestReference 函数始终调用 pDataProviderIn 参数指向的CRYPT_XML_DATA_PROVIDER结构的 fpnClose 成员所指向的函数。
 

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 cryptxml.h
Library Cryptxml.lib
DLL Cryptxml.dll