IOpcSignaturePartReferenceSet：：Create 方法 (msopc.h)

發行項
02/29/2024

建立 IOpcSignaturePartReference 介面指標，代表要簽署之元件的參考，並將新介面新增至集合。

語法

HRESULT Create(
  [in]          IOpcPartUri                 *partUri,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignaturePartReference  **partReference
);

參數

[in] partUri

IOpcPartUri，代表要參考之元件的元件名稱。

[in] digestMethod

要用於要參考之元件之部分內容的摘要方法。若要使用預設摘要方法，請將 NULL 傳遞至此參數。

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

[in] transformMethod

用於參考之元件之部分內容的標準化方法。

[out, retval] partReference

新的 IOpcSignaturePartReference 介面指標，代表要簽署之元件的參考。

如果不需要新介面的指標，此參數可以是 NULL 。

傳回值

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

傳回碼	描述
S_OK	此方法已成功。
E_INVALIDARG	在 transformMethod 參數中傳遞的值不是有效的 OPC_CANONICALIZATION_METHOD 列舉值。
E_POINTER	partUri 參數為 NULL。

備註

IOpcPart 介面只能參考可由 IOpcSignaturePartReference 介面指標表示的元件。關聯性元件是由 IOpcSignatureRelationshipReference 介面的指標所參考。若要建立 IOpcSignatureRelationshipReference 介面指標，請呼叫 IOpcSignatureRelationshipReferenceSet：：Create 方法。

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

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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