Metodo IShellItemArray::BindToHandler (shobjidl_core.h)

Articolo
03/13/2024

Esegue l'associazione a un oggetto tramite il gestore specificato.

Sintassi

HRESULT BindToHandler(
  [in]  IBindCtx *pbc,
  [in]  REFGUID  bhid,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

Parametri

[in] pbc

Tipo: IBindCtx*

Puntatore a un'interfaccia IBindCtx su un oggetto contesto di associazione.

[in] bhid

Tipo: REFGUID

Uno dei valori seguenti, definiti in Shlguid.h, che determinano il gestore.

BHID_SFUIObject

Limita l'utilizzo a GetUIObjectOf. Usare questo tipo di gestore solo per una matrice di elementi flat, in cui tutti gli elementi si trovano nella stessa cartella.

BHID_DataObject

Introdotto in Windows Vista: ottiene un oggetto IDataObject da utilizzare con un elemento o una matrice di elementi. Usare questo tipo di gestore solo per oggetti dati flat o matrici di elementi creati da SHCreateShellItemArrayFromDataObject.

BHID_AssociationArray

Introdotto in Windows Vista: ottiene un oggetto IQueryAssociations da utilizzare con un elemento o una matrice di elementi. In questo modo viene recuperato solo l'oggetto matrice di associazioni per il primo elemento in IShellItemArray

[in] riid

Tipo: REFIID

IID del tipo di oggetto da recuperare.

[out] ppvOut

Tipo: void**

Quando termina, questo metodo contiene l'oggetto specificato in 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 Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite