IXpsSignatureManager：：AddSignatureBlock 方法 (xpsdigitalsignature.h)

项目
12/22/2023

创建新的 IXpsSignatureBlock 接口，并将其添加到签名块集合。

语法

HRESULT AddSignatureBlock(
  [in]          IOpcPartUri        *partName,
  [in]          UINT32             fixedDocumentIndex,
  [out, retval] IXpsSignatureBlock **signatureBlock
);

参数

[in] partName

指向包含新部件 URI 的 IOpcPartUri 接口的指针。对于生成部件名称的方法，可以将此参数设置为 NULL。

[in] fixedDocumentIndex

要与新签名块关联的 FixedDocument 部件的索引值。

[out, retval] signatureBlock

指向新 IXpsSignatureBlock 接口的指针。如果不需要访问新接口，则可以将此参数设置为 NULL。

返回值

该方法返回 HRESULT。可能的值包括但不限于后面的表中的值。有关此表中未列出的返回值，请参阅 XPS 数字签名 API 错误和 XPS 文档错误。

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	fixedDocumentIndex 引用在 XPS 包中找不到的固定文档。
XPS_E_PACKAGE_NOT_OPENED	尚未在签名管理器中打开 XPS 包。

注解

签名块表示 XPS 包中的 SignatureDefinitions 部件。根据 XML 纸张规范中的第 10.2.2 节，可以将零个或多个 SignatureDefinitions 部件附加到每个 FixedDocument。此方法使用指定名称创建新的 SignatureDefinitions 部件，通过关系将其从指定的 FixedDocument 部件链接，创建新的 IXpsSignatureBlock 接口，并将此新接口添加到内部签名块集合。

若要检索签名块，请调用 GetSignatureBlocks 方法。

要求

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