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

[アーティクル]
02/29/2024

リレーションシップパーツへの参照を表す IOpcSignatureRelationshipReference インターフェイスポインターを作成し、新しいインターフェイスポインターをセットに追加します。参照するリレーションシップパーツに格納されているリレーションシップのすべてまたはサブセットが、署名用に選択されます。

構文

HRESULT Create(
  [in]          IOpcUri                            *sourceUri,
  [in]          LPCWSTR                            digestMethod,
  [in]          OPC_RELATIONSHIPS_SIGNING_OPTION   relationshipSigningOption,
  [in]          IOpcRelationshipSelectorSet        *selectorSet,
  [in]          OPC_CANONICALIZATION_METHOD        transformMethod,
  [out, retval] IOpcSignatureRelationshipReference **relationshipReference
);

パラメーター

[in] sourceUri

署名用に選択するリレーションシップのソース URI を表す IOpcUri インターフェイスポインター。

[in] digestMethod

選択するリレーションシップに使用するダイジェストメソッド。既定のダイジェストメソッドを使用するには、このパラメーターに NULL を 渡します。

大事なIOpcDigitalSignatureManager::Sign が呼び出される前に、IOpcSigningOptions::SetDefaultDigestMethod メソッドを呼び出して、既定のダイジェストメソッドを設定する必要があります。

[in] relationshipSigningOption

署名のために選択したリレーションシップに、参照するリレーションシップパーツ内のリレーションシップのすべてまたはサブセットが含まれるかどうかを示す値です。

relationshipSigningOption 値が他のパラメーターに与える影響については、「解説」を参照してください。

[in] selectorSet

署名用に選択するリレーションシップパーツ内のリレーションシップのサブセットを識別するために使用できる IOpcRelationshipSelectorSet インターフェイスポインター。

relationshipSigningOption がOPC_RELATIONSHIP_SIGN_PARTに設定されている場合、selectorSet は NULL です。

selectorSet 値の詳細については、「解説」を参照してください。

[in] transformMethod

選択したリレーションシップのリレーションシップマークアップに適用する正規化方法を表す値。

relationshipSigningOption がOPC_RELATIONSHIP_SIGN_USING_SELECTORS設定されている場合、transformMethod の値は無視されます。

relationshipSigningOption がOPC_RELATIONSHIP_SIGN_USING_SELECTORSに設定されている場合に適用される変換メソッドの詳細については、「解説」を参照してください。

[out, retval] relationshipReference

参照されるリレーションシップパーツを表す新しい IOpcSignatureRelationshipReference インターフェイスポインター。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	relationshipSigningOption パラメーターで渡された値が、有効なOPC_RELATIONSHIPS_SIGNING_OPTION列挙値ではありません。
E_INVALIDARG	transformMethod パラメーターで渡される値は、有効なOPC_CANONICALIZATION_METHOD列挙値ではありません。
E_POINTER	sourceUri パラメーターは NULL です。
E_UNEXPECTED	relationshipSigningOption パラメーターに OPC_RELATIONSHIP_SIGN_PART の値が渡されている間、selectorSet パラメーターは NULL に渡されません。

注釈

このメソッドは、リレーションシップパーツへの参照を作成します。参照されるリレーションシップパーツに格納されているリレーションシップのすべてまたはサブセットは、署名の生成時に署名できます。

リレーションシップパーツ内のすべてのリレーションシップに署名するには、 relationshipSigningOption パラメーター値を OPC_RELATIONSHIP_SIGN_PART に設定し、 selectorSet パラメーター値を NULL に設定して、このメソッドを呼び出 します。

リレーションシップパーツ内のリレーションシップのサブセットに署名するには、 relationshipSigningOption パラメーター値を OPC_RELATIONSHIP_SIGN_USING_SELECTORS に設定し、 selectorSet パラメーター値を IOpcRelationshipSelectorSet インターフェイスポインターに設定して、このメソッドを呼び出します。 IOpcRelationshipSelectorSet インターフェイスポインターを作成するには、CreateRelationshipSelectorSet メソッドを呼び出します。

次の表は、すべてのリレーションシップまたはリレーションシップのサブセット (参照するリレーションシップパーツに格納されている) を署名するかどうかを示す参照を作成するために、このメソッドで必要なパラメーター値をまとめたものです。

説明	relationshipSigningOption 値	selectorSet 値
リレーションシップパーツ内のすべてのリレーションシップに署名する	OPC_RELATIONSHIP_SIGN_PART	NULL
リレーションシップパーツ内のリレーションシップのサブセットに署名する	OPC_RELATIONSHIP_SIGN_USING_SELECTORS	IOpcRelationshipSelectorSet インターフェイスポインター

リレーションシップのサブセットに署名する場合、指定された変換メソッドは無視されます。代わりに、シグネチャが生成されるときに適用される最初の変換はリレーションシップ変換で、2 つ目は OPC_CANONICALIZATION_C14N 正規化メソッドです。

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

署名されないリレーションシップは、署名を無効にすることなく、パッケージに削除、変更、または追加できます。署名のためにリレーションシップのサブセットが選択されていて、そのサブセットが変更された場合、署名は無効になります。

大事な 選択したサブセットは、参照されるリレーションシップパーツに追加または変更されたリレーションシップのリレーションシップの種類が、サブセット内の 1 つ以上のリレーションシップを選択するために使用されたリレーションシップの種類と一致する場合に変更できます。

スレッドセーフ

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

詳細については、Packaging API を使用したはじめにに関するページを参照してください。

要件

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