Share via

IBindCtx::GetObjectParam-Methode (objidl.h)

  • Artikel

Ruft einen Schnittstellenzeiger auf das Objekt ab, das dem angegebenen Schlüssel in der Zeichenfolgentabelle des Bindungskontexts zugeordnet ist.

Syntax

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

Parameter

[in] pszKey

Der Bindkontextzeichenfolgenschlüssel , nach dem gesucht werden soll. Beim Schlüsselzeichenfolgenvergleich wird die Groß-/Kleinschreibung beachtet.

[out] ppunk

Die Adresse einer IUnknown*-Zeigervariable, die den Schnittstellenzeiger auf das Objekt empfängt, das pszKey zugeordnet ist. Bei erfolgreicher Ausführung ruft die Implementierung AddRef für *ppunk auf. Es liegt in der Verantwortung des Aufrufers , Release aufzurufen. Wenn ein Fehler auftritt, legt die Implementierung *ppunk auf NULL fest.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls ist es E_FAIL.

Hinweise

Ein Bindungskontext verwaltet eine Tabelle mit Schnittstellenzeigern, die jeweils einem Zeichenfolgenschlüssel zugeordnet sind. Dies ermöglicht die Kommunikation zwischen einer Monikerimplementierung und dem Aufrufer, der den Bindungsvorgang initiiert hat. Eine Partei kann einen Schnittstellenzeiger unter einer Zeichenfolge speichern, die beiden Parteien bekannt ist, sodass die andere Partei ihn später aus dem Bindungskontext abrufen kann.

Der Zeiger, den diese Methode abruft, muss zuvor mithilfe der IBindCtx::RegisterObjectParam-Methode in die Tabelle eingefügt worden sein.

Hinweise für Anrufer

Objekte, die Moniker verwenden, um andere Objekte zu suchen, können diese Methode aufrufen, wenn bei einem Bindungsvorgang keine spezifischen Informationen über den aufgetretenen Fehler abgerufen werden können. Je nach Fehler kann es möglich sein, die Situation zu korrigieren und den Bindungsvorgang erneut zu versuchen. Weitere Informationen finden Sie unter IBindCtx::RegisterObjectParam .

Moniker-Implementierungen können diese Methode aufrufen, um Situationen zu behandeln, in denen ein Aufrufer einen Bindungsvorgang initiiert und bestimmte Informationen anfordert. Gemäß der Konvention sollte der Implementierer Schlüsselnamen verwenden, die mit der Zeichenfolgenform der CLSID einer Monikerklasse beginnen. (Weitere Informationen finden Sie in der StringFromCLSID-Funktion .)

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

Ibindctx