IShellItemArray::BindToHandler 方法 (shobjidl_core.h)

通过指定的处理程序绑定到 对象。

语法

HRESULT BindToHandler(
  [in]  IBindCtx *pbc,
  [in]  REFGUID  bhid,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

参数

[in] pbc

类型: IBindCtx*

指向绑定上下文对象上的 IBindCtx 接口的指针。

[in] bhid

类型: REFGUID

以下值之一,在 Shlguid.h 中定义,用于确定处理程序。

BHID_SFUIObject

限制使用 GetUIObjectOf。 仅将此处理程序类型用于平面项数组,其中所有项都位于同一文件夹中。

BHID_DataObject

在 Windows Vista 中引入:获取与项或项数组一起使用的 IDataObject 对象。 仅将此处理程序类型用于 由 SHCreateShellItemArrayFromDataObject 创建的平面数据对象或项数组。

BHID_AssociationArray

在 Windows Vista 中引入:获取用于项或项数组的 IQueryAssociations 对象。 这仅检索 IShellItemArray 中第一项的关联数组对象

[in] riid

类型: REFIID

要检索的对象类型的 IID。

[out] ppvOut

类型: void**

此方法返回时,包含 riid 中指定的对象,该对象由 rbhid 指定的处理程序返回。

返回值

类型: HRESULT

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

要求

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