IRunningObjectTable_GetObject

指定したモニカーで識別されるオブジェクトが実行中かどうかを判定し、実行中であればそのオブジェクトへのポインタを取得する。

IRunningObjectTable_GetObject this, pmkObjectName, ppunkObject

this : [comobj] IRunningObjectTable インターフェースの COM オブジェクト変数
pmkObjectName : [comobj] モニカー上の IMoniker インターフェースへのポインタ。
ppunkObject : [int] 実行中のオブジェクトへのインターフェースポインタを受け取る IUnknown ポインタ変数へのポインタ。成功時には実装はオブジェクトに対して AddRef を呼ぶ。Release を呼ぶのは呼び出し側の責任である。オブジェクトが実行中でないか、エラーが発生した場合、実装は *ppunkObject を NULL に設定する。

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

解説

指定したモニカーで識別されるオブジェクトが実行中かどうかを判定し、実行中であればそのオブジェクトへのポインタを取得する。

[戻り値]
このメソッドは次の値を返すことがある。
（以下省略）

[備考]
このメソッドは pmkObjectName で指定されたモニカーを ROT 内で確認する。そのモニカーが以前に
IRunningObjectTable::Register
呼び出しで登録されていた場合、このメソッドはその時に登録されたポインタを返す。呼び出し側への注意 一般に
IRunningObjectTable::GetObject メソッドを呼ぶのは、独自のモニカークラスを書いている場合 (すなわち
IMoniker インターフェースを実装している場合) のみである。通常は IMoniker::BindToObject
の実装内から呼び出す。ただしすべての IMoniker::BindToObject
実装がこのメソッドを呼ぶ必要があるわけではない。モニカーにプレフィックス (IMoniker::BindToObject の非 NULL
pmkToLeft パラメータで示される) があると想定される場合、ROT を確認すべきではない。理由は、ROT
には完全なモニカーのみが登録されるからであり、プレフィックス付きモニカーは合成の一部であって完全ではないためである。この場合モニカーは代わりに、プレフィックスで識別されるオブジェクト
(例: 自分のモニカーで識別されるオブジェクトのコンテナ) にサービスを要求すべきである。

情報