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。 若要检索 IStream、 IStorage 或 IPropertySetStorage 接口指针,请将 riid 分别设置为 IID_IStream、 IID_IStorage 或 IID_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 或更高版本) |