IOpcUri::CombinePartUri メソッド (msopc.h)

指定した相対 URI によって参照されるパーツのパーツ名を形成します。パーツの指定された相対 URI は、現在の OPC URI オブジェクトとして表される URI に対して解決されます。

構文

HRESULT CombinePartUri(
  [in]          IUri        *relativeUri,
  [out, retval] IOpcPartUri **combinedUri
);

[in] relativeUri

パーツの相対 URI の IUri インターフェイスへのポインター。

パーツ名を表すパーツ URI オブジェクトを形成するために、この入力 URI は、現在の OPC URI オブジェクトとして表される URI に対して解決されます。したがって、入力 URI は、現在の OPC URI オブジェクトによって表される URI に対して相対的である必要があります。

この URI にはフラグメントコンポーネントが含まれる場合があります。ただし、フラグメントは無視され、形成されるパーツ名には含まれません。「 RFC 3986: URI ジェネリック構文」で説明されているように、フラグメントコンポーネントの前に '#' が付きます。

[out, retval] combinedUri

パーツ名を表すパーツ URI オブジェクトの IOpcPartUri インターフェイスへのポインター。

部分 URI オブジェクトは、現在の OPC URI オブジェクトによって表される URI に対して relativeUri の相対 URI を解決することによって形成されます。

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

リターンコード/値	説明
S_OK	メソッドが成功しました。
E_FAIL	CoInternetCombineUrl 関数から無効なサイズが返されました。
E_POINTER	relativeUri パラメーターと combinedUri パラメーターの少なくとも 1 つが NULL です。
E_UNEXPECTED	CoInternetCombineUrl 関数に必要なバッファーのサイズが予期せず変更されました。
OPC_E_NONCONFORMING_URI 0x80510001	パーツ名は OPC 標準で指定されている規則に準拠していません。
OPC_E_RELATIVE_URI_REQUIRED 0x80510002	パーツ名を絶対 URI にすることはできません。 RFC 3986: URI ジェネリック構文で説明されているように、絶対 URI はスキーマコンポーネントの後に ":" が続きます。
CoInternetCombineUrl 関数エラー	CoInternetCombineUrl 関数からの HRESULT エラーコード。
CreateUri 関数エラー	CreateUri 関数からの HRESULT エラーコード。
WinINet エラー	WinINet API からの HRESULT エラーコード。

入力と出力の例:

このメソッドを使用してパーツ名を解決する方法については、「ターゲット URI からパーツ名を解決する」を参照してください。

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

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

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


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