MonikerCommonPrefixWith

このモニカ（このモニカオブジェクトのデータを構成するモニカ）と別のモニカが共有する共通プレフィックスに基づき、新しいモニカを作成する。

MonikerCommonPrefixWith pmkThis, pmkOther, ppmkCommon

pmkThis : [var] 共通プレフィックスを求める対象の一方のモニカ上の IMoniker インターフェイスへのポインタ。通常、この呼び出しを IMoniker::CommonPrefixWith の実装に使用しているモニカ自身を指す。
pmkOther : [var] 最初のモニカと比較される、もう一方のモニカ上の IMoniker インターフェイスへのポインタ。
ppmkCommon : [var] pmkThis と pmkOther の共通プレフィックスに基づくモニカへのインターフェイスポインタを受け取る IMoniker* ポインタ変数のアドレス。成功時、関数はモニカに対して AddRef を呼び出しており、呼び出し側が Release を呼び出す責任を負う。エラー発生時、指定されたインターフェイスポインタの値は NULL となる。

(プラグイン / モジュール : ole32.dll)

解説

このモニカ（このモニカオブジェクトのデータを構成するモニカ）と別のモニカが共有する共通プレフィックスに基づき、新しいモニカを作成する。

[戻り値]
この関数は標準の戻り値 E_OUTOFMEMORY および E_UNEXPECTED に加えて以下の値を返すことがある。
（以下省略）

[備考]
IMoniker::CommonPrefixWith
の実装では、まず相手のモニカが自分が認識して特別な方法で扱える型かどうかを確認すべきである。そうでない場合、自身を
pmkThis、相手のモニカを pmkOther として MonikerCommonPrefixWith
を呼び出すこと。MonikerCommonPrefixWith は、どちらかのモニカが汎用合成である場合も正しく処理する。
この関数は、pmkThis と pmkOther
の両方が絶対モニカである場合にのみ呼び出すこと。ここで絶対モニカとは、ファイルモニカまたは最左成分がファイルモニカである汎用合成モニカで、かつそのファイルモニカが絶対パスを表すものをいう。相対モニカに対してこの関数を呼び出してはならない。

情報