IOpcSignatureReferenceSet：：Create 方法 (msopc.h)

發行項
03/05/2024

建立 IOpcSignatureReference 介面指標，代表要簽署之 XML 項目的參考。

語法

HRESULT Create(
  [in]          IUri                        *referenceUri,
  [in]          LPCWSTR                     referenceId,
  [in]          LPCWSTR                     type,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignatureReference      **reference
);

參數

[in] referenceUri

參考之 XML 專案的 URI。

將此參數的值設定為表示 “#” 的 URI，後面接著所參考專案的 Id 屬性值：“#<elementIdValue>”。

如需範例，請參閱一節。

[in] referenceId

Reference 元素的 Id 屬性，表示簽章標記中的參考。若要省略 Id 屬性，請將此參數值設定為 NULL。

[in] type

Reference 元素的 Type 屬性，表示簽章標記中的參考。若要省略 Type 屬性，請將此參數值設定為 NULL。

[in] digestMethod

要用於要參考之 XML 標記的摘要方法。若要使用預設摘要方法，請將此參數值設定為 NULL。

重要呼叫 IOpcDigitalSignatureManager：：Sign 之前，必須先呼叫 IOpcSigningOptions：：SetDefaultDigestMethod 方法來設定預設摘要方法。

[in] transformMethod

要用於參考之 XML 標記的標準化方法。

[out, retval] reference

新的 IOpcSignatureReference 介面指標，表示要簽署之 XML 項目的參考。

傳回值

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼/值	描述
S_OK	此方法已成功。
E_INVALIDARG	在 transformMethod 參數中傳遞的值不是有效的OPC_CANONICALIZATION_METHOD列舉值。
E_POINTER	referenceUri 參數為 NULL。
OPC_E_DS_PACKAGE_REFERENCE_URI_RESERVED 0x80510025	將簽章之 Reference 元素的保留 URI 屬性值用於封裝 Object，做為自定義 Object 元素參考的 URI 屬性值。

備註

這個方法會建立產生簽章時所簽署之 XML 項目的參考。參考的專案可以是應用程式特定的 Object 元素或應用程式特定 物件的子系。

若要參考 XML 元素進行簽署，請將 referenceUri 參數值設定為代表 “#” 的 URI，後面接著所參考專案的 Id 屬性值，如下表所示。

referenceUri 以字串表示的值	Referenced 元素	元素描述
“#idMyCustomObject”	“<Object Id=”idMyCustomObject“>...</Object>”	應用程式特定的 Object 專案。
“#idMyElement”	“<Object><MyElement Id=”idMyElement“>...</MyElement>...</Object>”	應用程式特定物件的子專案。

這個方法不會建立要簽署之封裝特定 Object 項目的參考;產生簽章時，會自動建立該參考。

建立 IOpcSignatureReference 介面指標並新增至集合時，會在儲存封裝時儲存它所代表的參考。

執行緒安全性

封裝物件不是安全線程。

如需詳細資訊，請參閱使用封裝 API 使用者入門。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	msopc.h