SHBindToFolderIDListParent 函数 (shlobj_core.h)

给定以文件夹的形式指定的 Shell 命名空间项，以及相对于该文件夹的项目标识符列表，此函数将绑定到命名空间项的父级，并选择性地返回指向项标识符列表的最终组件的指针。

语法

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*

指向 Shell 文件夹对象的指针。 如果 psfRoot 为 NULL，则指示传递的 IDList 相对于桌面。

[in] pidl

类型： PCUIDLIST_RELATIVE

要绑定到的 PIDL，相对于 psfRoot。 如果 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