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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shobjidl_core.h (inclua Shobjidl.h) |
| DLL | Shell32.dll (versão 5.00 ou posterior) |