IOpcRelationship::GetTargetUri メソッド (msopc.h)

リレーションシップターゲットの URI を取得します。

構文

HRESULT GetTargetUri(
  [out, retval] IUri **targetUri
);

[out, retval] targetUri

リレーションシップのターゲットの URI を表す URI の IUri インターフェイスへのポインター。

リレーションシップターゲットが内部の場合、ターゲットはパーツであり、ターゲットの URI はソースパーツの URI を基準にしています。

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	targetUri パラメーターは NULL です。

関心のある部分を見つける決定的な方法は、リレーションシップの種類を使用することです。

関心のある部分を見つけるには、いくつかの手順が必要です。パーツの検索の詳細については、「パーツの概要」および「コアプロパティパーツの検索」を参照してください。

リレーションシップのターゲットが内部か外部かを判断するには、 GetTargetUri メソッドを呼び出します。

リレーションシップターゲットが内部の場合、ターゲットは一部です。

リレーションシップターゲットが一部である場合、 targetUri の URI はリレーションシップソースの URI を基準にしています。

リレーションシップターゲットがパーツの場合は、GetSourceUri メソッドの sourceUri パラメーターで受信した IOpcUri インターフェイスポインターから IOpcUri::CombinePartUri メソッドを呼び出して、パーツ名を形成します。 targetUri で受信した相対 URI を、IOpcUri::CombinePartUri 呼び出しの入力パラメーターとして使用します。例については、「ターゲット URI からのパーツ名の解決」を参照してください。

リレーションシップの詳細については、 Open Packaging Conventions Fundamentals と ECMA-376 OpenXML、1st Edition、Part 2: Open Packaging Conventions (OPC) を参照してください。

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

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