IBindCtx::RevokeObjectParam-Methode (objidl.h)

  • Artikel

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.

Syntax

HRESULT RevokeObjectParam(
  [in] LPOLESTR pszKey
);

Parameter

[in] pszKey

Der zu entfernende Bindungskontextzeichenfolgenschlüssel . Beim Schlüsselzeichenfolgenvergleich wird die Groß-/Kleinschreibung beachtet.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der angegebene Schlüssel wurde erfolgreich entfernt.
S_FALSE
 Das Objekt wurde zuvor nicht registriert.

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.

Diese Methode wird verwendet, um einen Eintrag aus der Tabelle zu entfernen. Wenn der angegebene Schlüssel gefunden wird, gibt der Bindungskontext auch seinen Verweis auf das -Objekt frei.

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