IConnectionPoint::Unadvise-Methode (ocidl.h)

  • Artikel

Beendet eine Empfehlungsverbindung, die zuvor zwischen einem Verbindungspunktobjekt und der Senke eines Clients hergestellt wurde.

Syntax

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Parameter

[in] dwCookie

Ein Verbindungstoken, das zuvor von IConnectionPoint::Advise zurückgegeben wurde.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Die Verbindung wurde erfolgreich beendet.
E_POINTER
 Der Wert in dwCookie stellt keine gültige Verbindung dar.

Hinweise

Wenn eine Empfehlungsverbindung beendet wird, ruft der Verbindungspunkt die Release-Methode auf dem Zeiger auf, der während der IConnectionPoint::Advise-Methode für die Verbindung gespeichert wurde. In diesem Release wird das AddRef rückgängig gemacht, das während der Empfehlung ausgeführt wurde, wenn der Verbindungspunkt das QueryInterface der Advisory-Senke aufruft.

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

Weitere Informationen

IConnectionPoint