IShellFolder::BindToStorage 方法 (shobjidl_core.h)

请求指向对象的存储接口的指针。

语法

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

参数

[in] pidl

类型: PCUIDLIST_RELATIVE

相对于其父文件夹标识子文件夹的 ITEMIDLIST 结构的地址。 结构必须恰好包含一个 SHITEMID 结构,后跟一个终止零。

[in] pbc

类型: IBindCtx*

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

[in] riid

类型: REFIID

请求的存储接口的 IID。 若要检索 IStreamIStorageIPropertySetStorage 接口指针,请将 riid 分别设置为 IID_IStreamIID_IStorageIID_IPropertySetStorage

[out] ppv

类型: void**

接收 riid 指定的接口指针的地址。 如果发生错误,则会在此地址中返回 NULL 指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

命名空间扩展可以选择允许应用程序绑定到表示项存储的对象。 如果支持此选项, 则 IShellFolder::BindToStorage 将返回一个指定的接口指针,该指针随后可用于访问对象的内容。 有关进一步的讨论,请参阅 IMoniker::BindToStorage 参考。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll (版本 4.0 或更高版本)