IXpsSignatureManager：：AddSignatureBlock 方法 (xpsdigitalsignature.h)

發行項
03/05/2024

建立新的 IXpsSignatureBlock 介面，並將它新增至簽章區塊集合。

語法

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

參數

[in] partName

IOpcPartUri 介面的指標，其中包含新元件的 URI。若要讓方法產生元件名稱，此參數可以設定為 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