Método IShellItemArray::BindToHandler (shobjidl_core.h)

Enlaza a un objeto mediante el controlador especificado.

Sintaxis

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

Parámetros

[in] pbc

Tipo: IBindCtx*

Puntero a una interfaz IBindCtx en un objeto de contexto de enlace.

[in] bhid

Tipo: REFGUID

Uno de los siguientes valores, definidos en Shlguid.h, que determinan el controlador.

BHID_SFUIObject

Restringe el uso a GetUIObjectOf. Use este tipo de controlador solo para una matriz de elementos planos, donde todos los elementos están en la misma carpeta.

BHID_DataObject

Introducido en Windows Vista: obtiene un objeto IDataObject para su uso con un elemento o una matriz de elementos. Use este tipo de controlador solo para objetos de datos planos o matrices de elementos creadas por SHCreateShellItemArrayFromDataObject.

BHID_AssociationArray

Introducido en Windows Vista: obtiene un objeto IQueryAssociations para su uso con un elemento o una matriz de elementos. Esto solo recupera el objeto de matriz de asociación para el primer elemento de IShellItemArray.

[in] riid

Tipo: REFIID

IiD del tipo de objeto que se va a recuperar.

[out] ppvOut

Tipo: void**

Cuando estos métodos devuelven, contiene el objeto especificado en riid devuelto por el controlador especificado por rbhid.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)