IOpcRelationshipSelector インターフェイス (msopc.h)

[アーティクル]
10/26/2023

リレーションシップパーツから、署名のために参照するリレーションシップを選択する方法を表します。

継承

IOpcRelationshipSelector インターフェイスは、IUnknown インターフェイスから継承されます。 IOpcRelationshipSelector には、次の種類のメンバーもあります。

メソッド

IOpcRelationshipSelector インターフェイスには、これらのメソッドがあります。


IOpcRelationshipSelector::GetSelectionCriterion 署名のために参照するリレーションシップを選択するために使用される文字列を取得します。
IOpcRelationshipSelector::GetSelectorType 署名のために参照するリレーションシップの選択方法を示す値を取得します。

注釈

IOpcRelationshipSelector インターフェイスポインターを作成するには、IOpcRelationshipSelectorSet::Create メソッドを呼び出します。

IOpcRelationshipSelector にアクセスするには、IOpcRelationshipSelectorEnumerator::GetCurrent メソッドを呼び出します。

IOpcRelationshipSelector インターフェイスメソッドを使用して、署名するリレーションシップを選択します。リレーションシップは、その型または識別子が、GetSelectionCriterion メソッドを呼び出して取得した文字列と一致する場合に選択されます。この文字列は、リレーションシップの種類またはリレーションシップ識別子です。 GetSelectorType メソッドを呼び出してOPC_RELATIONSHIP_SELECTOR値を取得し、文字列がリレーションシップ型か識別子かを判断します。これらのリレーションシッププロパティにアクセスするには、 IOpcRelationship::GetRelationshipType メソッドと IOpcRelationship::GetId メソッドを呼び出します。

次の表に、 OPC_RELATIONSHIP_SELECTOR 値をリレーションシップの種類とリレーションシップ識別子のプロパティにマップする方法を示します。

OPC_RELATIONSHIP_SELECTOR 値	Relationship プロパティ	説明
OPC_RELATIONSHIP_SELECT_BY_TYPE	リレーションシップの種類	selectionCriterion 文字列と一致するリレーションシップの種類を持つリレーションシップを選択します。
OPC_RELATIONSHIP_SELECT_BY_ID	リレーションシップ識別子	selectionCriterion 文字列と一致するリレーションシップ識別子を持つリレーションシップを選択します。

署名が生成されると、インターフェイスによって提供されるリレーションシップの選択情報が、署名の XML マークアップ (署名マークアップ) でシリアル化されます。シグネチャマークアップでは、この情報は、セクション 12 で指定されている RelationshipReference 要素と RelationshipGroupReference 要素によって表されます。 ECMA-376 OpenXML、第 1 版、パート 2: Open Packaging Conventions (OPC) のデジタル署名。次の表は、要素がリレーションシッププロパティと OPC_RELATIONSHIP_SELECTOR 値にマップされる方法を示しています。

パッケージ署名要素	Relationship プロパティ	OPC_RELATIONSHIP_SELECTOR 値
RelationshipGroupReference	リレーションシップの種類	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	リレーションシップ識別子	OPC_RELATIONSHIP_SELECT_BY_ID

スレッドセーフ

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

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

要件

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