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) |