SHBindToObject 函数 （shlobj_core.h）

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

Syntax

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。 由于对 网吧 的支持对于文件夹对象实现是可选的，因此某些文件夹可能不支持使用绑定上下文。

riid

类型： REFIID

要返回的接口的标识符。

[out] ppv

类型： void**

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

返回值

类型：HRESULT

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

注解

要求

另请参阅

IShellFolder

IShellFolder：：BindToObject