SHBindToObject 函数 (shlobj_core.h)

  • 项目

使用 Shell 命名空间 IShellFolder：：BindToObject 方法检索并绑定到指定的对象。

语法

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

参数

psf

类型： IShellFolder*

指向 IShellFolder 的指针。 此参数可以为 NULL。 如果 psf 为 NULL，则表示参数 pidl 相对于桌面。 在这种情况下， pidl 必须指定绝对 ITEMIDLIST。

pidl

类型： PCUIDLIST_RELATIVE

指向要绑定到的常量 ITEMIDLIST 的指针，该常量相对于 psf。 如果 psf 为 NULL，则这是相对于桌面文件夹的绝对 ITEMIDLIST 。

[in] pbc

类型： IBindCtx*

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

riid

类型： REFIID

要返回的接口的标识符。

[out] ppv

类型： void**

此方法返回时，包含 riid 中指定的接口指针，指向绑定对象。 如果发生错误，则 包含 NULL 指针。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

注意 这是一个帮助程序函数，它通过调用 SHGetDesktopFolder 获取桌面对象。
 

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h (包括 Shlobj.h)
DLL Shell32.dll

另请参阅

IShellFolder

IShellFolder：：BindToObject