IOleAdviseHolder::Advise-Methode (oleidl.h)

  • Artikel

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
E_INVALIDARG
 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

Weitere Informationen

IOleAdviseHolder

IOleAdviseHolder::EnumAdvise

IOleAdviseHolder::Unadvise

IOleObject::Advise