MonikerRelativePathTo 関数 (objbase.h)

  • [アーティクル]

指定した最初のモニカーの末尾 (または類似の構造を持つモニカー) に構成されると、2 番目に指定されたモニカーを生成するモニカーを提供します。

この関数は、 IMoniker::RelativePathTo 実装でのみ使用することを目的としています。

構文

HRESULT MonikerRelativePathTo(
  [in]  LPMONIKER pmkSrc,
  [in]  LPMONIKER pmkDest,
  [out] LPMONIKER *ppmkRelPath,
  [in]  BOOL      dwReserved
);

パラメーター

[in] pmkSrc

作成する相対モニカーで構成されると pmkDest を生成するモニカー上の IMoniker インターフェイスへのポインター。 このモニカーは、作成する相対モニカーの "ソース" を識別します。

[in] pmkDest

pmkSrc に対して相対的に表されるモニカー上の IMoniker インターフェイスへのポインター。 このモニカーは、作成する相対モニカーの宛先を識別します。

[out] ppmkRelPath

新しい相対モニカーへのインターフェイス ポインターを受け取る IMoniker* ポインター変数のアドレス。 成功した場合、関数はモニカーで AddRef を呼び出し、呼び出し元は Release を呼び出す役割を担います。 エラーが発生した場合、インターフェイス ポインター値は NULL です。

[in] dwReserved

このパラメーターは予約済みであり、0 以外である必要があります。

戻り値

この関数は、標準の戻り値E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、および次の値を返すことができます。

リターン コード 説明
S_OK
 意味のある相対パスが返されました。
MK_S_HIM
 相対パスの唯一の形式は、もう 1 つのモニカーです。
MK_E_NOTBINDABLE
 pmkSrc パラメーターは、アイテム モニカーなどの相対モニカーであり、相対パスを決定する前に、コンテナーのモニカーで構成する必要があります。

注釈

IMoniker::RelativePathTo の実装では、まず、他のモニカーが特別な方法で認識して処理する型であるかどうかをチェックする必要があります。 そうでない場合は、 MonikerRelativePathTo を呼び出し、それ自体を pmkThis として渡し、もう一方のモニカーを pmkOther として渡す必要があります。 MonikerRelativePathTo は、いずれかのモニカーが汎用複合である場合を正しく処理します。

この関数は 、pmkSrc と pmkDest の両方が絶対モニカーである場合にのみ呼び出す必要があります。絶対モニカーは、ファイル モニカーまたは一番左のコンポーネントがファイル モニカーであり、ファイル モニカーが絶対パスを表す汎用複合です。 相対モニカーでは、この関数を呼び出さないでください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー objbase.h
Library Ole32.lib
[DLL] Ole32.dll

こちらもご覧ください

IMoniker::RelativePathTo