Método IShellItem::BindToHandler (shobjidl_core.h)
Enlaza a un controlador para un elemento según lo especificado por el valor de identificador de controlador (BHID).
Sintaxis
HRESULT BindToHandler(
IBindCtx *pbc,
REFGUID bhid,
REFIID riid,
void **ppv
);
Parámetros
pbc
Tipo: IBindCtx*
Puntero a una interfaz IBindCtx en un objeto de contexto de enlace. Se usa para pasar parámetros opcionales al controlador. El contenido del contexto de enlace es específico del controlador. Por ejemplo, cuando se enlaza a BHID_Stream, las marcas STGM en el contexto de enlace indican el modo de acceso deseado (lectura o lectura y escritura).
bhid
Tipo: REFGUID
Referencia a un GUID que especifica qué controlador se creará. Uno de los siguientes valores definidos en Shlguid.h:
BHID_SFObject
Restringe el uso a BindToObject.
BHID_SFUIObject
Restringe el uso a GetUIObjectOf.
BHID_SFViewObject
Restringe el uso a CreateViewObject.
BHID_Storage
Intenta recuperar el RIID de almacenamiento, pero el valor predeterminado es la implementación de Shell en caso de error.
BHID_Stream
Restringe el uso a IStream.
BHID_LinkTargetItem
CLSID_ShellItem se inicializa con el destino de este elemento (solo se puede SFGAO_LINK). Consulte SFGAO para obtener una descripción de SFGAO_LINK.
BHID_StorageEnum
Si el elemento es una carpeta, obtiene un objeto IEnumShellItems con el que se enumera el contenido del almacenamiento.
BHID_Transfer
Introducido en Windows Vista: si el elemento es una carpeta, obtiene un objeto ITransferSource o ITransferDestination .
BHID_PropertyStore
Introducido en Windows Vista: restringe el uso a IPropertyStore o IPropertyStoreFactory.
BHID_ThumbnailHandler
Introducido en Windows Vista: restringe el uso a IExtractImage o IThumbnailProvider.
BHID_EnumItems
Introducido en Windows Vista: si el elemento es una carpeta, obtiene un objeto IEnumShellItems que enumera todos los elementos de la carpeta. Esto incluye carpetas, no carpetas y elementos ocultos.
BHID_DataObject
Introducido en Windows Vista: obtiene un objeto IDataObject para su uso con un elemento o una matriz de elementos.
BHID_AssociationArray
Introducido en Windows Vista: obtiene un objeto IQueryAssociations para su uso con un elemento o una matriz de elementos.
BHID_Filter
Introducido en Windows Vista: restringe el uso a IFilter.
BHID_EnumAssocHandlers
Introducido en Windows 7: obtiene un objeto IEnumAssocHandlers usado para enumerar los controladores de asociación recomendados para el elemento especificado.
BHID_RandomAccessStream
Introducido en Windows 8: obtiene un objeto IRandomAccessStream para el elemento.
BHID_FilePlaceholder
Introducido en Windows 8.1: obtiene un objeto utilizado para proporcionar funcionalidad de archivo de marcador de posición.
riid
Tipo: REFIID
IID del tipo de objeto que se va a recuperar.
ppv
Tipo: void**
Cuando este método finaliza, contiene un puntero de tipo 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 XP con SP1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |
| Archivo DLL | Shell32.dll (versión 5.00 o posterior) |