IConnectionPoint::Advise-Methode (ocidl.h)
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 |
|---|---|
|
Die Verbindung wurde hergestellt, und *pdwCookie verfügt über das Verbindungstoken. |
|
Der Wert in pUnkSink oder pdwCookie ist ungültig. Beispielsweise kann jeder Zeiger NULL sein. |
|
Der Verbindungspunkt hat bereits seine maximale Anzahl von Verbindungen erreicht und kann keine weiteren Verbindungen annehmen. |
|
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 |