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

Artículo
03/15/2023

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)

Consulte también

IShellFolder

IShellItem

Share via