IShellItem::BindToHandler-Methode (shobjidl_core.h)

Bindet an einen Handler für ein Element, wie durch den Handler-ID-Wert (BHID) angegeben.

Syntax

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

Parameter

pbc

Typ: IBindCtx*

Ein Zeiger auf eine IBindCtx-Schnittstelle in einem Bindungskontextobjekt. Wird verwendet, um optionale Parameter an den Handler zu übergeben. Der Inhalt des Bindungskontexts ist handlerspezifisch. Beispiel: Bei der Bindung an BHID_Stream geben die STGM-Flags im Bindungskontext den gewünschten Zugriffsmodus an (Lese- oder Lese-/Schreibzugriff).

bhid

Typ: REFGUID

Verweis auf eine GUID, die angibt, welcher Handler erstellt wird. Einer der folgenden Werte, die in Shlguid.h definiert sind:

BHID_SFObject

Schränkt die Verwendung auf BindToObject ein.

BHID_SFUIObject

Schränkt die Verwendung auf GetUIObjectOf ein.

BHID_SFViewObject

Schränkt die Verwendung auf CreateViewObject ein.

BHID_Storage

Versucht, die Speicher-RIID abzurufen, wird jedoch bei Einem Fehler standardmäßig shellimplementiert.

BHID_Stream

Schränkt die Verwendung auf IStream ein.

BHID_LinkTargetItem

CLSID_ShellItem mit dem Ziel dieses Elements initialisiert wird (kann nur SFGAO_LINK werden). Eine Beschreibung der SFGAO_LINK finden Sie unter SFGAO .

BHID_StorageEnum

Wenn es sich bei dem Element um einen Ordner handelt, ruft ein IEnumShellItems-Objekt ab, mit dem der Speicherinhalt aufgelistet werden soll.

BHID_Transfer

Eingeführt in Windows Vista: Wenn das Element ein Ordner ist, ruft ein ITransferSource - oder ITransferDestination-Objekt ab.

BHID_PropertyStore

Eingeführt in Windows Vista: Beschränkt die Verwendung auf IPropertyStore oder IPropertyStoreFactory.

BHID_ThumbnailHandler

In Windows Vista eingeführt: Beschränkt die Verwendung auf IExtractImage oder IThumbnailProvider.

BHID_EnumItems

Eingeführt in Windows Vista: Wenn das Element ein Ordner ist, ruft ein IEnumShellItems-Objekt ab, das alle Elemente im Ordner auflistet. Dies umfasst Ordner, Nichtordner und ausgeblendete Elemente.

BHID_DataObject

Eingeführt in Windows Vista: Ruft ein IDataObject-Objekt zur Verwendung mit einem Element oder einem Array von Elementen ab.

BHID_AssociationArray

Eingeführt in Windows Vista: Ruft ein IQueryAssociations-Objekt zur Verwendung mit einem Element oder einem Array von Elementen ab.

BHID_Filter

Einführung in Windows Vista: Beschränkt die Verwendung auf IFilter.

BHID_EnumAssocHandlers

Eingeführt in Windows 7: Ruft ein IEnumAssocHandlers-Objekt ab, das zum Auflisten der empfohlenen Zuordnungshandler für das angegebene Element verwendet wird.

BHID_RandomAccessStream

Eingeführt in Windows 8: Ruft ein IRandomAccessStream-Objekt für das Element ab.

BHID_FilePlaceholder

Eingeführt in Windows 8.1: Ruft ein Objekt ab, das zum Bereitstellen von Platzhalterdateifunktionen verwendet wird.

riid

Typ: REFIID

IID des abzurufenden Objekttyps.

ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält einen Zeiger vom Typ riid , der von dem 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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)
DLL Shell32.dll (Version 5.00 oder höher)

Weitere Informationen

IShellFolder

IShellItem