SHBindToFolderIDListParentEx 関数 (shlobj_core.h)
呼び出し元がバインド コンテキストを指定できるようにすることで 、SHBindToFolderIDListParent 関数を拡張します。
構文
SHSTDAPI SHBindToFolderIDListParentEx(
[in, optional] IShellFolder *psfRoot,
[in] PCUIDLIST_RELATIVE pidl,
[in, optional] IBindCtx *ppbc,
[in] REFIID riid,
[out] void **ppv,
[out, optional] PCUITEMID_CHILD *ppidlLast
);
パラメーター
[in, optional] psfRoot
種類: IShellFolder*
シェル フォルダー オブジェクトへのポインター。 psfRoot が NULL の場合、渡された IDList がデスクトップに対する相対パスであることを示します。
[in] pidl
種類: PCUIDLIST_RELATIVE
psfRoot を基準にしてバインドする PIDL。 psfRoot が NULL の場合、これはデスクトップ フォルダーに対する絶対 IDList です。
[in, optional] ppbc
型: IBindCtx*
この操作中に使用されるバインド コンテキスト オブジェクト上の IBindCtx インターフェイスへのポインター。 このパラメーターを使用しない場合は、 それを NULL に設定します。これは 、SHBindToFolderIDListParent 関数の呼び出しと同じです。 pbc のサポートはフォルダー オブジェクトの実装では省略可能であるため、一部のフォルダーではバインド コンテキストの使用がサポートされない場合があります。
[in] riid
型: REFIID
目的のインターフェイス ID への参照。 これは通常、IID_IShellFolderまたはIID_IShellFolder2ですが、ターゲット フォルダーでサポートされるものは何でもかまいません。
[out] ppv
型: void**
この関数が戻るときに、 riid で要求されたインターフェイス ポインターを格納します。 これは通常 、IShellFolder または IShellFolder2 ですが、ターゲット フォルダーでサポートされるものは何でもかまいません。
[out, optional] ppidlLast
種類: PCUITEMID_CHILD*
pidl パラメーターの最後の ID へのポインターであり、ppv で返される親フォルダーを基準とした子 ID です。 この値には NULL を指定できます。
戻り値
型: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlobj_core.h (Shlobj.h を含む) |
| [DLL] | Shell32.dll |