IOpcSignaturePartReferenceSet::Create メソッド (msopc.h)

[アーティクル]
08/25/2023

署名するパーツへの参照を表す 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 です。

注釈

IOpcSignaturePartReference インターフェイスポインターによって参照できるのは、IOpcPart インターフェイスで表すことができるパーツだけです。リレーションシップパーツは、 IOpcSignatureRelationshipReference インターフェイスへのポインターによって署名するために参照されます。 IOpcSignatureRelationshipReference インターフェイスポインターを作成するには、IOpcSignatureRelationshipReferenceSet::Create メソッドを呼び出します。

IOpcSignaturePartReference インターフェイスポインターが作成され、セットに追加されると、それが表す参照はパッケージの保存時に保存されます。

スレッドセーフ

オブジェクトのパッケージ化はスレッドセーフではありません。

詳細については、「Packaging API を使用したはじめに」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msopc.h