BindMoniker-Funktion (objbase.h)
Sucht ein Objekt mithilfe seines Monikers, aktiviert das Objekt, wenn es inaktiv ist, und ruft einen Zeiger auf die angegebene Schnittstelle für dieses Objekt ab.
Syntax
HRESULT BindMoniker(
[in] LPMONIKER pmk,
[in] DWORD grfOpt,
[in] REFIID iidResult,
[out] LPVOID *ppvResult
);
Parameter
[in] pmk
Ein Zeiger auf den Moniker des Objekts. Siehe IMoniker.
[in] grfOpt
Dieser Parameter ist für die zukünftige Verwendung reserviert und muss 0 sein.
[in] iidResult
Der Schnittstellenbezeichner, der für die Kommunikation mit dem -Objekt verwendet werden soll.
[out] ppvResult
Die Adresse der Zeigervariable, die den in iidResult angeforderten Schnittstellenzeiger empfängt. Nach erfolgreicher Rückgabe enthält *ppvResult den angeforderten Schnittstellenzeiger. Wenn ein Fehler auftritt, ist *ppvResultNULL. Wenn der Aufruf erfolgreich ist, ist der Aufrufer dafür verantwortlich, den Zeiger mit einem Aufruf der IUnknown::Release-Methode des Objekts freizugeben.
Rückgabewert
Diese Funktion kann die folgenden Fehlercodes oder einen der von der IMoniker::BindToObject-Methode zurückgegebenen Fehlerwerte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Das Objekt wurde gefunden und bei Bedarf aktiviert, und ein Zeiger auf die angeforderte Schnittstelle wurde zurückgegeben. |
|
Das Vom Moniker-Objekt identifizierte Objekt konnte nicht gefunden werden. |
Hinweise
BindMoniker ist eine Hilfsfunktion, die als bequeme Möglichkeit für einen Client bereitgestellt wird, der über den Moniker eines Objekts verfügt, um einen Zeiger auf eine der Schnittstellen dieses Objekts abzurufen. BindMoniker packt die folgenden Aufrufe:
CreateBindCtx(0, &pbc);
pmk->BindToObject(pbc, NULL, riid, ppvObj);
CreateBindCtx erstellt ein Bindkontextobjekt, das die Systemimplementierung von IBindContext unterstützt. Der pmk-Parameter ist tatsächlich ein Zeiger auf die IMoniker-Implementierung für ein Moniker-Objekt. Die BindToObject-Methode dieser Implementierung stellt den Zeiger auf den angeforderten Schnittstellenzeiger bereit.
Wenn Sie mehrere Moniker in schneller Folge binden und wissen, dass diese Moniker dasselbe Objekt aktivieren, ist es möglicherweise effizienter, die IMoniker::BindToObject-Methode direkt aufzurufen, sodass Sie dasselbe Bindungskontextobjekt für alle Moniker verwenden können. Weitere Informationen finden Sie in der IBindCtx-Schnittstelle .
Containeranwendungen, die es ihren Dokumenten erlauben, verknüpfte Objekte zu enthalten, sind ein spezieller Client, der in der Regel keine direkten Aufrufe von IMoniker-Methoden ausführt. Stattdessen bearbeitet der Client die verknüpften Objekte über die IOleLink-Schnittstelle . Der Standardhandler implementiert diese Schnittstelle und ruft bei Bedarf die entsprechenden IMoniker-Methoden auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objbase.h |
| Bibliothek | Ole32.lib |
| DLL | Ole32.dll |
| APIs | ext-ms-win-com-ole32-l1-1-5 (eingeführt in Windows 10, Version 10.0.15063) |