BindMoniker

モニカを使ってオブジェクトを特定し、非アクティブであればアクティブ化し、指定されたインターフェイスへのポインタを取得する。

BindMoniker pmk, grfOpt, iidResult, ppvResult

pmk : [var] オブジェクトのモニカへのポインタ。IMoniker を参照。
grfOpt : [int] このパラメータは将来の使用のために予約されており、0 を指定しなければならない。
iidResult : [var] オブジェクトと通信するために使用するインターフェイス識別子。
ppvResult : [var] iidResult で要求したインターフェイスポインタを受け取るポインタ変数のアドレス。正常終了した場合、*ppvResult には要求されたインターフェイスポインタが格納される。エラーが発生した場合、*ppvResult は NULL となる。呼び出しが成功した場合、呼び出し側はそのオブジェクトの IUnknown::Release メソッドを呼び出してポインタを解放する責任を負う。

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

解説

モニカを使ってオブジェクトを特定し、非アクティブであればアクティブ化し、指定されたインターフェイスへのポインタを取得する。

[戻り値]
この関数は以下のエラーコード、または IMoniker::BindToObject メソッドが返すいずれかのエラー値を返すことがある。
(以下省略)

[備考]
BindMoniker
は、オブジェクトのモニカを保持するクライアントがそのオブジェクトのインターフェイスへのポインタを取得するための便利な補助関数である。BindMoniker
は以下の呼び出しをまとめて行う。
(以下省略)

情報

プラグイン / モジュールole32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の ole32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_ole32_gen2.hs