SHBindToObject

シェル名前空間の IShellFolder::BindToObject メソッドを使って、指定したオブジェクトを取得してバインドする。

SHBindToObject psf, pidl, pbc, riid, ppv

psf : [var] 型: IShellFolder* IShellFolder へのポインタ。このパラメータは NULL でも構わない。psf が NULL の場合、これは pidl がデスクトップを基準とすることを示す。この場合、pidl は絶対 ITEMIDLIST を指定しなければならない。
pidl : [var] 型: PCUIDLIST_RELATIVE psf を基準としてバインドする定数 ITEMIDLIST へのポインタ。psf が NULL の場合、これはデスクトップフォルダを基準とする絶対 ITEMIDLIST である。
pbc : [var] 型: IBindCtx* この操作中に使用するバインドコンテキストオブジェクトの IBindCtx インタフェースへのポインタ。このパラメータを使用しない場合は NULL に設定する。pbc のサポートはフォルダオブジェクト実装ではオプションのため、フォルダによってはバインドコンテキストの使用をサポートしないことがある。
riid : [var] 型: REFIID 返すインタフェースの識別子。
ppv : [var] 型: void** このメソッドから戻る際に、バインド先オブジェクトの、riid で指定したインタフェースポインタを格納する。エラーが発生した場合は NULL ポインタを格納する。

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

解説

シェル名前空間の IShellFolder::BindToObject メソッドを使って、指定したオブジェクトを取得してバインドする。

[戻り値]
型: HRESULT 関数が成功した場合は S_OK を返す。そうでない場合は HRESULT エラーコードを返す。

[備考]
Note これは SHGetDesktopFolder を呼び出してデスクトップオブジェクトを取得するヘルパ関数である。

情報