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

こちらもご覧ください

SHBindToFolderIDListParent