IOpcPartUri::GetSourceUri メソッド (msopc.h)

リレーションシップパーツに格納されているリレーションシップのソース URI を取得します。現在のパーツ URI オブジェクトは、そのリレーションシップパーツのパーツ名を表します。

構文

HRESULT GetSourceUri(
  [out, retval] IOpcUri **sourceUri
);

[out, retval] sourceUri

リレーションシップパーツに格納されているリレーションシップのソースの URI を表す OPC URI オブジェクトの IOpcUri インターフェイスへのポインター。

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

リターンコード/値	説明
S_OK	メソッドが成功しました。
E_POINTER	sourceUri パラメーターは NULL です。
OPC_E_RELATIONSHIP_URI_REQUIRED 0x80510003	リレーションシップパーツのパーツ名は必須ですが、パーツ名はリレーションシップパーツの名前ではありません。リレーションシップパーツのパーツ名の詳細については、 OPC を参照してください。
CreateUri 関数エラー	CreateUri 関数からの HRESULT エラーコード。
WinINet エラー	WinINet API からの HRESULT エラーコード。

現在のパーツ URI オブジェクトが、パッケージのリレーションシップ ("/_rels/.rels") を格納する Relationships パーツのパーツ名を表す場合、 sourceUri で返される OPC URI オブジェクトはパッケージルート ("/") を表します。

現在のパーツ URI オブジェクトが Relationships パーツのパーツ名でない場合、このメソッドは OPC_E_RELATIONSHIP_URI_REQUIRED エラーで失敗します。リレーションシップパーツ名の構文は OPC で指定されています。

次の表は、現在の部分 URI と、このメソッドによって返されるソース URI を示しています。

現在のパーツ URI	現在のパーツ URI の説明	ソース URI	ソース URI の説明	戻り値
/mydoc/_rels/picture.jpg.rels	リレーションシップパーツのパーツ名	/mydoc/picture.jpg	現在のパーツ URI オブジェクトによって表される Relationships パーツに格納されているリレーションシップのソースであるパーツのパーツ名	S_OK
/_rels/.rels	リレーションシップパーツのパーツ名	/	パッケージルート。現在のパーツ URI オブジェクトによって表される Relationships パーツに格納されているリレーションシップのソース	S_OK
/mydoc/image/chart1.jpg	リレーションシップパーツではないパーツのパーツ名	未定義。	未定義。	OPC_E_RELATIONSHIP_URI_REQUIRED
/_rels/a.jpg	リレーションシップパーツではないパーツのパーツ名	未定義。	未定義。	OPC_E_RELATIONSHIP_URI_REQUIRED

このメソッドの動作とパフォーマンスは、サポートされているすべての Windows バージョンで同じです。詳細については、「Packaging API を使用したはじめに」および「Windows Vista 用プラットフォーム更新プログラム」を参照してください。

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

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

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