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

Associa a um manipulador para um item, conforme especificado pelo valor da ID do manipulador (BHID).

Sintaxe

HRESULT BindToHandler(
  IBindCtx *pbc,
  REFGUID  bhid,
  REFIID   riid,
  void     **ppv
);

Parâmetros

pbc

Tipo: IBindCtx*

Um ponteiro para uma interface IBindCtx em um objeto de contexto de associação. Usado para passar parâmetros opcionais para o manipulador. O conteúdo do contexto de associação é específico do manipulador. Por exemplo, ao associar a BHID_Stream, os sinalizadores STGM no contexto de associação indicam o modo de acesso desejado (leitura ou leitura/gravação).

bhid

Tipo: REFGUID

Referência a um GUID que especifica qual manipulador será criado. Um dos seguintes valores definidos em Shlguid.h:

BHID_SFObject

Restringe o uso a BindToObject.

BHID_SFUIObject

Restringe o uso a GetUIObjectOf.

BHID_SFViewObject

Restringe o uso a CreateViewObject.

BHID_Storage

Tenta recuperar o RIID de armazenamento, mas o padrão é a implementação do Shell em caso de falha.

BHID_Stream

Restringe o uso ao IStream.

BHID_LinkTargetItem

CLSID_ShellItem é inicializado com o destino deste item (só pode ser SFGAO_LINK). Consulte SFGAO para obter uma descrição do SFGAO_LINK.

BHID_StorageEnum

Se o item for uma pasta, obterá um objeto IEnumShellItems com o qual enumerar o conteúdo de armazenamento.

BHID_Transfer

Introduzido no Windows Vista: se o item for uma pasta, obterá um objeto ITransferSource ou ITransferDestination .

BHID_PropertyStore

Introduzido no Windows Vista: restringe o uso a IPropertyStore ou IPropertyStoreFactory.

BHID_ThumbnailHandler

Introduzido no Windows Vista: restringe o uso a IExtractImage ou IThumbnailProvider.

BHID_EnumItems

Introduzido no Windows Vista: se o item for uma pasta, obterá um objeto IEnumShellItems que enumera todos os itens na pasta. Isso inclui pastas, não pastas e itens ocultos.

BHID_DataObject

Introduzido no Windows Vista: obtém um objeto IDataObject para uso com um item ou uma matriz de itens.

BHID_AssociationArray

Introduzido no Windows Vista: obtém um objeto IQueryAssociations para uso com um item ou uma matriz de itens.

BHID_Filter

Introduzido no Windows Vista: restringe o uso ao IFilter.

BHID_EnumAssocHandlers

Introduzido no Windows 7: obtém um objeto IEnumAssocHandlers usado para enumerar os manipuladores de associação recomendados para o item fornecido.

BHID_RandomAccessStream

Introduzido em Windows 8: obtém um objeto IRandomAccessStream para o item.

BHID_FilePlaceholder

Introduzido em Windows 8.1: obtém um objeto usado para fornecer funcionalidade de arquivo de espaço reservado.

riid

Tipo: REFIID

IID do tipo de objeto a ser recuperado.

ppv

Tipo: void**

Quando esse método retorna, contém um ponteiro do tipo 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

Confira também

Ishellfolder

Ishellitem