IMoniker_ParseDisplayName

表示名をモニカーに変換する。

IMoniker_ParseDisplayName this, pbc, pmkToLeft, pszDisplayName, pchEaten, ppmkOut

this : [comobj] IMoniker インターフェースの COM オブジェクト変数
pbc : [comobj] このバインド操作で使用するバインドコンテキストの IBindCtx インターフェースへのポインタ。バインドコンテキストは、バインド処理中にバインドされたオブジェクトをキャッシュし、バインドコンテキストを使用するすべての操作に適用されるパラメータを含み、モニカー実装がその環境について情報を取得するための手段を提供する。
pmkToLeft : [comobj] ここまでに表示名から構築されたモニカーの IMoniker インターフェースへのポインタ。
pszDisplayName : [wstr] 解析の残りの表示名。
pchEaten : [int] このステップで消費された pszDisplayName 中の文字数を受け取る変数へのポインタ。
ppmkOut : [comobj] pszDisplayName から構築されたモニカーへのインターフェースポインタを受け取る IMoniker ポインタ変数へのポインタ。成功時、実装は新しいモニカーに対して AddRef を呼び出さなければならない。呼び出し側は Release を呼び出す責任がある。エラーが発生した場合、実装は *ppmkOut を NULL に設定する。

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

解説

表示名をモニカーに変換する。

[戻り値]
このメソッドは、標準の戻り値 E_OUTOFMEMORY および E_UNEXPECTED のほか、以下の値を返す場合がある。
（以下省略）

[備考]
呼び出し側への注意: モニカークライアントは通常 ParseDisplayName
を直接呼び出さない。代わりに、表示名をモニカーに変換したい場合は MkParseDisplayName 関数を呼び出す
(例えば、コンテナアプリケーションのリンクダイアログボックスの実装、またはドキュメント外のオブジェクトへの参照をサポートするマクロ言語の実装)。その関数はまず、表示名の最初の部分を自身で解析する。次に、作成したばかりのモニカーに対して
ParseDisplayName
を呼び出し、表示名の残りを渡して、新しいモニカーを受け取る。このステップが表示名全体が解析されるまで繰り返される。実装者への注意:
モニカークラスが特定種類のオブジェクトのみを指定するように設計されている場合、この解析を自身で行えるかもしれない。そうでなければ、ここまでのモニカー
(すなわち pmkToLeft とこのモニカーの合成) が識別するオブジェクトから IParseDisplayName
インターフェースポインタを取得し、IParseDisplayName::ParseDisplayName
を呼び出した結果を返さなければならない。IParseDisplayName ポインタを取得する戦略はいくつかある。
（以下省略）

情報