Metodo IShellItem::BindToHandler (shobjidl_core.h)

Articolo
03/15/2023

Esegue il binding a un gestore per un elemento come specificato dal valore DELL'ID gestore (BHID).

Sintassi

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

Parametri

pbc

Tipo: IBindCtx*

Puntatore a un'interfaccia IBindCtx su un oggetto contesto di associazione. Usato per passare parametri facoltativi al gestore. Il contenuto del contesto di associazione è specifico del gestore. Ad esempio, quando si esegue l'associazione a BHID_Stream, i flag STGM nel contesto di associazione indicano la modalità di accesso desiderata (lettura o lettura/scrittura).

bhid

Tipo: REFGUID

Riferimento a un GUID che specifica il gestore che verrà creato. Uno dei valori seguenti definiti in Shlguid.h:

BHID_SFObject

Limita l'utilizzo a BindToObject.

BHID_SFUIObject

Limita l'utilizzo a GetUIObjectOf.

BHID_SFViewObject

Limita l'utilizzo a CreateViewObject.

BHID_Storage

Tenta di recuperare il RIID di archiviazione, ma per impostazione predefinita viene predefinito l'implementazione della shell in caso di errore.

BHID_Stream

Limita l'utilizzo a IStream.

BHID_LinkTargetItem

CLSID_ShellItem viene inizializzato con la destinazione di questo elemento (può essere SFGAO_LINK). Per una descrizione di SFGAO_LINK, vedere SFGAO .

BHID_StorageEnum

Se l'elemento è una cartella, ottiene un oggetto IEnumShellItems con cui enumerare il contenuto dell'archiviazione.

BHID_Transfer

Introdotto in Windows Vista: se l'elemento è una cartella, ottiene un oggetto ITransferSource o ITransferDestination .

BHID_PropertyStore

Introdotto in Windows Vista: limita l'utilizzo a IPropertyStore o IPropertyStoreFactory.

BHID_ThumbnailHandler

Introdotto in Windows Vista: limita l'utilizzo a IExtractImage o IThumbnailProvider.

BHID_EnumItems

Introdotto in Windows Vista: se l'elemento è una cartella, ottiene un oggetto IEnumShellItems che enumera tutti gli elementi nella cartella. Sono incluse cartelle, non cartelle ed elementi nascosti.

BHID_DataObject

Introdotto in Windows Vista: ottiene un oggetto IDataObject da utilizzare con un elemento o una matrice di elementi.

BHID_AssociationArray

Introdotto in Windows Vista: ottiene un oggetto IQueryAssociations da utilizzare con un elemento o una matrice di elementi.

BHID_Filter

Introdotto in Windows Vista: limita l'utilizzo a IFilter.

BHID_EnumAssocHandlers

Introdotto in Windows 7: ottiene un oggetto IEnumAssocHandlers usato per enumerare i gestori di associazione consigliati per l'elemento specificato.

BHID_RandomAccessStream

Introdotto in Windows 8: ottiene un oggetto IRandomAccessStream per l'elemento.

BHID_FilePlaceholder

Introdotto in Windows 8.1: ottiene un oggetto utilizzato per fornire la funzionalità del file segnaposto.

riid

Tipo: REFIID

IID del tipo di oggetto da recuperare.

ppv

Tipo: void**

Quando termina, questo metodo contiene un puntatore di tipo riid restituito dal gestore specificato da rbhid.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 5.00 o successiva)

Vedi anche

IShellFolder

IShellItem