IOleAdviseHolder::Advise-Methode (oleidl.h)
Stellt eine Empfehlungsverbindung zwischen einem OLE-Objekt und der Empfehlungssenke des aufrufenden Objekts her. Über diese Senke kann das aufrufende Objekt eine Benachrichtigung erhalten, wenn das OLE-Objekt umbenannt, gespeichert oder geschlossen wird.
Syntax
HRESULT Advise(
[in] IAdviseSink *pAdvise,
[out] DWORD *pdwConnection
);
Parameter
[in] pAdvise
Ein Zeiger auf die IAdviseSink-Schnittstelle auf der Empfehlungssenke, die über Änderungen informiert werden soll.
[out] pdwConnection
Ein Zeiger auf ein Token, das an die IOleAdviseHolder::Unadvise-Methode übergeben werden kann, um die Empfehlungsverbindung zu löschen. Das aufrufende Objekt ist für den Aufruf von IUnknown::AddRef und IUnknown::Release für diesen Zeiger verantwortlich.
Rückgabewert
Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:
| Rückgabecode | Beschreibung |
|---|---|
|
Der angegebene IAdviseSink-Schnittstellenzeiger ist ungültig. |
Hinweise
Container, Objekthandler und Verknüpfungsobjekte erstellen alle Empfehlungssenken, um Benachrichtigungen über Änderungen in interessanten Verbunddokumentobjekten wie eingebetteten oder verknüpften Objekten zu erhalten. OLE-Objekte, die für diese Objekte von Interesse sind, müssen die IOleObject-Schnittstelle implementieren, die mehrere Beratungsmethoden enthält, einschließlich IOleObject::Advise. Ein Aufruf dieser Methode muss eine Beratungsverbindung mit jeder Empfehlungssenke einrichten, die sie aufruft, und jede Verbindung beibehalten, bis sie geschlossen wird. Es muss in der Lage sein, mehrere Beratungsverbindungen gleichzeitig zu verarbeiten.
IOleAdviseHolder::Advise soll verwendet werden, um die Implementierung von IOleObject::Advise zu vereinfachen. Sie können einen Zeiger auf die OLE-Implementierung von IOleAdviseHolder abrufen, indem Sie CreateOleAdviseHolder aufrufen und dann zum Implementieren von IOleObject::Advise einfach den Aufruf an IOleAdviseHolder::Advise delegieren. Andere IOleAdviseHolder-Methoden sollen andere IOleObject-Empfehlungsmethoden implementieren.
Wenn der Versuch, eine Empfehlungsverbindung herzustellen, erfolgreich ist, gibt das Objekt, das den Aufruf empfängt, einen Wert ungleich null über pdwConnection zurück. Wenn der Versuch fehlschlägt, gibt das Objekt eine Null zurück. Um eine Empfehlungsverbindung zu löschen, übergibt das Objekt mit der Empfehlungssenke dieses Token ungleich null an das Objekt zurück, indem IOleAdviseHolder::Advise aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | oleidl.h |