SHBindToFolderIDListParentEx

呼び出し側がバインドコンテキストを指定できるようにすることで SHBindToFolderIDListParent 関数を拡張する。

SHBindToFolderIDListParentEx psfRoot, pidl, ppbc, riid, ppv, ppidlLast

psfRoot : [var] 型: IShellFolder* シェルフォルダオブジェクトへのポインタ。psfRoot が NULL の場合、渡された IDList はデスクトップを基準とすることを示す。
pidl : [var] 型: PCUIDLIST_RELATIVE psfRoot を基準としてバインド対象とする PIDL。psfRoot が NULL の場合、これはデスクトップフォルダを基準とする絶対 IDList である。
ppbc : [var] 型: IBindCtx* この操作中に使用するバインドコンテキストオブジェクトの IBindCtx インタフェースへのポインタ。このパラメータを使用しない場合は NULL に設定し、それは SHBindToFolderIDListParent 関数を呼び出すのと等価である。pbc のサポートはフォルダオブジェクト実装ではオプションのため、フォルダによってはバインドコンテキストの使用をサポートしないことがある。
riid : [var] 型: REFIID 目的のインタフェース ID への参照。通常は IID_IShellFolder または IID_IShellFolder2 だが、対象フォルダがサポートする任意のものでよい。
ppv : [var] 型: void** この関数から戻る際に、riid で要求されたインタフェースポインタを格納する。通常は IShellFolder または IShellFolder2 だが、対象フォルダがサポートする任意のものでよい。
ppidlLast : [var] 型: PCUITEMID_CHILD* pidl パラメータの最後の ID へのポインタで、ppv に返される親フォルダを基準とした子 ID である。この値は NULL でも構わない。

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

解説

呼び出し側がバインドコンテキストを指定できるようにすることで SHBindToFolderIDListParent 関数を拡張する。

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

情報