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*

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

[in] pidl

类型： PCUIDLIST_RELATIVE

要绑定到的 PIDL，相对于 psfRoot。 如果 psfRoot 为 NULL，则这是相对于桌面文件夹的绝对 IDList。

[in, optional] ppbc

类型： IBindCtx*

指向此操作期间要使用的绑定上下文对象上的 IBindCtx 接口的指针。 如果未使用此参数，请将其设置为 NULL，这等效于调用 SHBindToFolderIDListParent 函数。 由于对 bc 的支持对于文件夹对象实现是可选的，因此某些文件夹可能不支持使用绑定上下文。

[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