IOpcRelationshipSelector
COM公式ドキュメント
Relationships パートから、署名のために参照するリレーションシップをどのように選択するかを表します。
解説(Remarks)
<b>IOpcRelationshipSelector</b> インターフェイスポインターを作成するには、<a href="/previous-versions/windows/desktop/api/msopc/nf-msopc-iopcrelationshipselectorset-create">IOpcRelationshipSelectorSet::Create</a> メソッドを呼び出します。
IOpcRelationshipSelector にアクセスするには、IOpcRelationshipSelectorEnumerator::GetCurrent メソッドを呼び出します。
署名対象のリレーションシップを選択するには、IOpcRelationshipSelector インターフェイスのメソッドを使用します。リレーションシップは、その型または識別子が GetSelectionCriterion メソッドで取得される文字列と一致する場合に選択されます。この文字列は、リレーションシップの型またはリレーションシップの識別子のいずれかです。この文字列が型と識別子のどちらであるかを判別するには、GetSelectorType メソッドを呼び出して OPC_RELATIONSHIP_SELECTOR 値を取得します。これらのリレーションシップのプロパティにアクセスするには、IOpcRelationship::GetRelationshipType メソッドおよび IOpcRelationship::GetId メソッドを呼び出します。
次の表は、OPC_RELATIONSHIP_SELECTOR の値が、リレーションシップの型およびリレーションシップの識別子のプロパティにどのように対応するかを示しています。
| OPC_RELATIONSHIP_SELECTOR の値 | リレーションシップのプロパティ | 説明 |
|---|---|---|
| OPC_RELATIONSHIP_SELECT_BY_TYPE | リレーションシップの型 | selectionCriterion 文字列と一致するリレーションシップの型を持つリレーションシップを選択します。 |
| OPC_RELATIONSHIP_SELECT_BY_ID | リレーションシップの識別子 | selectionCriterion 文字列と一致するリレーションシップの識別子を持つリレーションシップを選択します。 |
署名が生成されると、このインターフェイスが提供するリレーションシップの選択情報が、署名の XML マークアップ (署名マークアップ) にシリアル化されます。署名マークアップでは、この情報は RelationshipReference 要素および RelationshipGroupReference 要素として表現されます。これらの要素は、ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC) のセクション 12「Digital Signatures」で規定されています。次の表は、これらの要素がリレーションシップのプロパティおよび OPC_RELATIONSHIP_SELECTOR の値にどのように対応するかを示しています。
| パッケージ署名の要素 | リレーションシップのプロパティ | OPC_RELATIONSHIP_SELECTOR の値 |
|---|---|---|
| RelationshipGroupReference | リレーションシップの型 | OPC_RELATIONSHIP_SELECT_BY_TYPE |
| RelationshipReference | リレーションシップの識別子 | OPC_RELATIONSHIP_SELECT_BY_ID |
スレッドセーフティ
パッケージング関連のオブジェクトはスレッドセーフではありません。
詳細については、Getting Started with the Packaging API を参照してください。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
署名のために参照するリレーションシップをどのように選択するかを表す値を取得します。
| selector | OPC_RELATIONSHIP_SELECTOR* | out | GetSelectionCriterion メソッドが返す文字列と比較される IOpcRelationship インターフェイスのプロパティを示す値。 |
戻り値
このメソッドは HRESULT を返します。戻り値には次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| selector パラメーターが NULL です。 |
解説(Remarks)
次の表は、OPC_RELATIONSHIP_SELECTOR の値が、リレーションシップの型およびリレーションシップの識別子のプロパティにどのように対応するかを示しています。
| OPC_RELATIONSHIP_SELECTOR の値 | リレーションシップのプロパティ | 説明 |
|---|---|---|
| OPC_RELATIONSHIP_SELECT_BY_TYPE | リレーションシップの型 | selectionCriterion 文字列と一致するリレーションシップの型を持つリレーションシップを選択します。 |
| OPC_RELATIONSHIP_SELECT_BY_ID | リレーションシップの識別子 | selectionCriterion 文字列と一致するリレーションシップの識別子を持つリレーションシップを選択します。 |
スレッドセーフティ
パッケージング関連のオブジェクトはスレッドセーフではありません。
詳細については、Getting Started with the Packaging API を参照してください。
署名のために参照するリレーションシップを選択するために使用される文字列を取得します。
| selectionCriterion | LPWSTR* | out | 署名のために参照するリレーションシップを選択するために使用される文字列。 |
戻り値
このメソッドは HRESULT を返します。戻り値には次の表に示すものが含まれますが、これらに限定されません。
| 戻り値 | 説明 |
|---|---|
| メソッドは成功しました。 | |
| selectionCriterion パラメーターが NULL です。 |
解説(Remarks)
このメソッドは、selectionCriterion で返される文字列が使用するメモリを割り当てます。メソッドが成功した場合は、CoTaskMemFree 関数を呼び出してメモリを解放してください。
署名対象のリレーションシップを選択するには、IOpcRelationshipSelector インターフェイスのメソッドを使用します。リレーションシップは、その型または識別子が GetSelectionCriterion メソッドで取得される文字列と一致する場合に選択されます。この文字列は、リレーションシップの型またはリレーションシップの識別子のいずれかです。この文字列が型と識別子のどちらであるかを判別するには、GetSelectorType メソッドを呼び出して OPC_RELATIONSHIP_SELECTOR 値を取得します。これらのリレーションシップのプロパティにアクセスするには、IOpcRelationship::GetRelationshipType メソッドおよび IOpcRelationship::GetId メソッドを呼び出します。
スレッドセーフティ
パッケージング関連のオブジェクトはスレッドセーフではありません。
詳細については、Getting Started with the Packaging API を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IOpcRelationshipSelector "{F8F26C7F-B28F-4899-84C8-5D5639EDE75F}" #usecom global IOpcRelationshipSelector IID_IOpcRelationshipSelector "{}" #comfunc global IOpcRelationshipSelector_GetSelectorType 3 var #comfunc global IOpcRelationshipSelector_GetSelectionCriterion 4 var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_IOpcRelationshipSelector "{F8F26C7F-B28F-4899-84C8-5D5639EDE75F}" #usecom global IOpcRelationshipSelector IID_IOpcRelationshipSelector "{}" #comfunc global IOpcRelationshipSelector_GetSelectorType 3 sptr #comfunc global IOpcRelationshipSelector_GetSelectionCriterion 4 sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。