IConnectionPoint::Advise-Methode (ocidl.h)

  • Artikel

Stellt eine Verbindung zwischen einem Verbindungspunktobjekt und der Senke des Clients her.

Syntax

HRESULT Advise(
  [in]  IUnknown *pUnkSink,
  [out] DWORD    *pdwCookie
);

Parameter

[in] pUnkSink

Ein Zeiger auf die IUnknown-Schnittstelle auf der Empfehlungssenke des Clients. Die Senke des Clients empfängt ausgehende Anrufe vom Verbindungspunkt.

[out] pdwCookie

Ein Zeiger auf ein zurückgegebenes Token, das diese Verbindung eindeutig identifiziert. Der Aufrufer verwendet dieses Token später, um die Verbindung zu löschen, indem er sie an die IConnectionPoint::Unadvise-Methode übergibt . Wenn die Verbindung nicht erfolgreich hergestellt wurde, ist dieser Wert 0.

Rückgabewert

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

Rückgabecode BESCHREIBUNG
S_OK
 Die Verbindung wurde hergestellt, und *pdwCookie verfügt über das Verbindungstoken.
E_POINTER
 Der Wert in pUnkSink oder pdwCookie ist ungültig. Beispielsweise kann jeder Zeiger NULL sein.
CONNECT_E_ADVISELIMIT
 Der Verbindungspunkt hat bereits seine maximale Anzahl von Verbindungen erreicht und kann keine weiteren Verbindungen annehmen.
CONNECT_E_CANNOTCONNECT
 Die Senke unterstützt die für diesen Verbindungspunkt erforderliche Schnittstelle nicht.

Hinweise

Advise stellt eine Verbindung zwischen dem Verbindungspunkt und der Senke des Aufrufers her, die mit pUnkSink identifiziert wurde.

Der Verbindungspunkt muss QueryInterface aufrufen, um den richtigen ausgehenden Schnittstellenzeiger abzurufen, der beim Auftreten von Ereignissen aufgerufen werden kann, wobei die IID für die ausgehende Schnittstelle vom Verbindungspunkt verwaltet wird. Wenn die IID an die IConnectionPointContainer::FindConnectionPoint-Methode übergeben wird, wird ein Schnittstellenzeiger auf diesen Verbindungspunkt zurückgegeben.

Hinweise zu Implementierern

Der Verbindungspunkt muss den pUnkSink-Zeiger nach der richtigen ausgehenden Schnittstelle abfragen. Wenn diese Abfrage fehlschlägt, muss diese Methode CONNECT_E_CANNOTCONNECT zurückgeben.

Der pdwCookie-Wert muss für jede Verbindung mit einem bestimmten instance eines Verbindungspunkts eindeutig sein.

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