Метод IShellItemArray::BindToHandler (shobjidl_core.h)

Статья
08/26/2023

Привязывается к объекту с помощью указанного обработчика.

Синтаксис

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
Header	shobjidl_core.h (включая Shobjidl.h)

Поделиться через