CryptXmlAddObject 函数 (cryptxml.h)

  • 项目

CryptXmlAddObject 函数将 Object 元素添加到文档上下文中为编码打开的签名。

语法

HRESULT CryptXmlAddObject(
  [in]            HCRYPTXML                hSignatureOrObject,
                  DWORD                    dwFlags,
  [in, optional]  const CRYPT_XML_PROPERTY *rgProperty,
  [in]            ULONG                    cProperty,
  [in]            const CRYPT_XML_BLOB     *pEncoded,
  [out, optional] const CRYPT_XML_OBJECT   **ppObject
);

参数

[in] hSignatureOrObject

CryptXmlOpenToEncode 函数返回的 Signature 的句柄，或由设置了 CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 标志的 CryptXmlCreateReference 函数返回的 Reference 的句柄。

dwFlags

指定控制添加对象的方式的标志。

下表中显示了当前定义的 dwFlags 值。

值 含义
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE
 设置后，将创建 XML 部件的内存中副本并将其包含在 Object 元素中。

[in, optional] rgProperty

指向 CRYPT_XML_PROPERTY 结构的指针，该结构指定用于解码 Object 元素的其他属性。

[in] cProperty

rgProperty 属性指向的数组中的元素数。

[in] pEncoded

指向包含 Object 元素的CRYPT_XML_BLOB结构的指针。

[out, optional] ppObject

指向指向 CRYPT_XML_OBJECT 结构的指针的指针，用于接收解码结构。 当 hSignatureOrObject 参数包含 Object 的句柄时，此参数必须为 NULL。

返回值

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

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

注解

当 hSignatureOrObject 参数指定由 CryptXmlCreateReference 函数返回的 Reference 的句柄时，pEncoded 参数指定在可选 Manifest 元素之后的 Object 节点中包含的 XML 内容。 pEncoded 参数中包含的指针在签名完成之前必须有效。 否则，请使用 CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY 标志创建内存中副本。

要求

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