IShellItemArray::BindToHandler-Methode (shobjidl_core.h)

Bindet mithilfe des angegebenen Handlers an ein -Objekt.

Syntax

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

Parameter

[in] pbc

Typ: IBindCtx*

Ein Zeiger auf eine IBindCtx-Schnittstelle in einem Bindungskontextobjekt.

[in] bhid

Typ: REFGUID

Einer der folgenden Werte, definiert in Shlguid.h, der den Handler bestimmt.

BHID_SFUIObject

Schränkt die Verwendung auf GetUIObjectOf ein. Verwenden Sie diesen Handlertyp nur für ein Array mit flachen Elementen, bei dem sich alle Elemente im selben Ordner befinden.

BHID_DataObject

Eingeführt in Windows Vista: Ruft ein IDataObject-Objekt zur Verwendung mit einem Element oder einem Array von Elementen ab. Verwenden Sie diesen Handlertyp nur für flache Datenobjekte oder Elementarrays, die von SHCreateShellItemArrayFromDataObject erstellt wurden.

BHID_AssociationArray

Eingeführt in Windows Vista: Ruft ein IQueryAssociations-Objekt zur Verwendung mit einem Element oder einem Array von Elementen ab. Dadurch wird nur das Zuordnungsarrayobjekt für das erste Element im IShellItemArray abgerufen.

[in] riid

Typ: REFIID

Die IID des abzurufenden Objekttyps.

[out] ppvOut

Typ: void**

Wenn diese Methode zurückgibt, enthält das in riid angegebene Objekt, das vom von rbhid angegebenen Handler zurückgegeben wird.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen