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

Artigo
03/02/2024

Associa a um objeto por meio do manipulador especificado.

Sintaxe

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

Parâmetros

[in] pbc

Tipo: IBindCtx*

Um ponteiro para uma interface IBindCtx em um objeto de contexto de associação.

[in] bhid

Tipo: REFGUID

Um dos valores a seguir, definidos em Shlguid.h, que determinam o manipulador.

BHID_SFUIObject

Restringe o uso a GetUIObjectOf. Use esse tipo de manipulador somente para uma matriz de itens simples, em que todos os itens estão na mesma pasta.

BHID_DataObject

Introduzido no Windows Vista: obtém um objeto IDataObject para uso com um item ou uma matriz de itens. Use esse tipo de manipulador somente para objetos de dados simples ou matrizes de itens criadas por SHCreateShellItemArrayFromDataObject.

BHID_AssociationArray

Introduzido no Windows Vista: obtém um objeto IQueryAssociations para uso com um item ou uma matriz de itens. Isso recupera apenas o objeto de matriz de associação para o primeiro item no IShellItemArray

[in] riid

Tipo: REFIID

A IID do tipo de objeto a ser recuperado.

[out] ppvOut

Tipo: void**

Quando esses métodos são retornados, contém o objeto especificado em riid que é retornado pelo manipulador especificado por rbhid.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Compartilhar via