IBindCtx-Schnittstelle (objidl.h)

Artikel
03/06/2024

Ermöglicht den Zugriff auf einen Bindungskontext, bei dem es sich um ein Objekt handelt, das Informationen zu einem bestimmten Monikerbindungsvorgang speichert.

Vererbung

Die IBindCtx-Schnittstelle erbt von der IUnknown-Schnittstelle . IBindCtx verfügt auch über die folgenden Typen von Membern:

Methoden

Die IBindCtx-Schnittstelle verfügt über diese Methoden.


IBindCtx::EnumObjectParam Ruft einen Zeiger auf eine Schnittstelle ab, die verwendet werden kann, um die Schlüssel der Zeichenfolgenschlüsseltabelle des Bindungskontexts aufzulisten.
IBindCtx::GetBindOptions Ruft die in diesem Bindungskontext gespeicherten Bindungsoptionen ab.
IBindCtx::GetObjectParam Ruft einen Schnittstellenzeiger auf das Objekt ab, das dem angegebenen Schlüssel in der Zeichenfolgenschlüsseltabelle des Bindungskontexts zugeordnet ist.
IBindCtx::GetRunningObjectTable Ruft einen Schnittstellenzeiger auf die ausgeführte Objekttabelle (ROT) für den Computer ab, auf dem dieser Bindungskontext ausgeführt wird.
IBindCtx::RegisterObjectBound Registriert ein Objekt beim Bindungskontext, um sicherzustellen, dass das Objekt aktiv bleibt, bis der Bindungskontext freigegeben wird.
IBindCtx::RegisterObjectParam Ordnet ein Objekt einem Zeichenfolgenschlüssel in der Zeichenfolgenschlüsseltabelle des Bindungskontexts zu.
IBindCtx::ReleaseBoundObjects Gibt alle Zeiger auf alle Objekte frei, die zuvor durch Aufrufe von RegisterObjectBound registriert wurden.
IBindCtx::RevokeObjectBound Entfernt das Objekt aus dem Bindungskontext und hebt einen vorherigen Aufruf von RegisterObjectBound auf.
IBindCtx::RevokeObjectParam Entfernt den angegebenen Schlüssel und den zugehörigen Zeiger aus der Zeichenfolgenschlüsseltabelle des Bindungskontexts. Der Schlüssel muss zuvor mit einem Aufruf von RegisterObjectParam in die Tabelle eingefügt worden sein.
IBindCtx::SetBindOptions Legt neue Werte für die bindungsparameter fest, die im Bindungskontext gespeichert sind.

Hinweise

Ein Bindungskontext enthält die folgenden Informationen:

Eine BIND_OPTS-Struktur , die einen Satz von Parametern enthält, die sich während des Bindungsvorgangs nicht ändern. Wenn ein zusammengesetzter Moniker gebunden ist, verwendet jede Komponente denselben Bindungskontext, sodass sie als Mechanismus zum Übergeben der gleichen Parameter an jede Komponente eines zusammengesetzten Monikers fungiert.
Eine Reihe von Zeigern auf Objekte, die vom Bindungsvorgang aktiviert wurden. Der Bindungskontext enthält Zeiger auf diese gebundenen Objekte, hält sie geladen und beseitigt somit redundante Aktivierungen, wenn die Objekte bei nachfolgenden Bindungsvorgängen erneut benötigt werden.
Ein Zeiger auf die ausgeführte Objekttabelle (ROT) auf demselben Computer wie der Prozess, der den Bindungsvorgang gestartet hat. Moniker-Implementierungen, die auf rot zugreifen müssen, sollten die IBindCtx::GetRunningObjectTable-Methode anstelle der GetRunningObjectTable-Funktion verwenden. Dadurch können zukünftige Verbesserungen der IBindCtx-Implementierung des Systems das Bindungsverhalten ändern.
Eine Tabelle mit Schnittstellenzeigern, die jeweils einem Zeichenfolgenschlüssel zugeordnet sind. Mit dieser Funktion können Monikerimplementierungen Schnittstellenzeiger unter einer bekannten Zeichenfolge speichern, sodass sie später aus dem Bindungskontext abgerufen werden können. Ole definiert beispielsweise mehrere Zeichenfolgenschlüssel ("ExceededDeadline", "ConnectManually" usw.), die verwendet werden können, um einen Zeiger auf das Objekt zu speichern, das während eines Bindungsvorgangs einen Fehler verursacht hat.

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	objidl.h

Weitere Informationen