SHBindToFolderIDListParent 関数 (shlobj_core.h)

  • [アーティクル]

フォルダーの形式で指定されたシェル名前空間アイテムと、そのフォルダーに対する相対的な項目識別子リストを指定すると、この関数は名前空間アイテムの親にバインドし、必要に応じてアイテム識別子リストの最後のコンポーネントへのポインターを返します。

構文

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [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] 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 エラー コードを返します。

注釈

メモSHBindToFolderIDListParent 関数の呼び出しは、バインド コンテキストとして NULL を使用して SHBindToFolderIDListParentEx 関数を呼び出すことと同じです。
 

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlobj_core.h (Shlobj.h を含む)
[DLL] Shell32.dll

こちらもご覧ください

SHBindToFolderIDListParentEx