IOleObject::EnumAdvise-Methode (oleidl.h)

Ruft einen Zeiger auf einen Enumerator ab, der zum Aufzählen der für ein Objekt registrierten Beratungsverbindungen verwendet werden kann, damit ein Container wissen kann, was vor dem Schließen freigegeben werden soll.

Syntax

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Parameter

[out] ppenumAdvise

Adresse der IEnumSTATDATA-Zeigervariable , die den Schnittstellenzeiger auf das Enumeratorobjekt empfängt. Wenn das Objekt über keine Empfehlungsverbindungen verfügt oder ein Fehler auftritt, muss die Implementierung ppenumAdvise auf NULL festlegen. Jedes Mal, wenn ein Objekt einen erfolgreichen Aufruf von IOleObject::EnumAdvise empfängt, muss die Verweisanzahl für ppenumAdvise erhöht werden. Es liegt in der Verantwortung des Aufrufers, Release aufzurufen, wenn dies mit ppenumAdvise erfolgt.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück. Weitere mögliche Rückgabewerte:

Hinweise

Die IOleObject::EnumAdvise-Methode stellt einen Enumerator bereit, der Containern die Möglichkeit bietet, die für ihre Objekte registrierten Beratungsverbindungen nachzuverfolgen. Normalerweise ruft ein Container diese Funktion auf, damit er ein Objekt anweisen kann, jede seiner Beratungsverbindungen vor dem Schließen freizugeben.

Der Enumerator, auf den Sie über IOleObject::EnumAdvise Zugriff erhalten, listet Elemente vom Typ STATDATA auf. Nach Dem Empfang des Zeigers kann der Container dann STATDATA durchlaufen und IOleObject::Unadvise für jede aufgezählte Verbindung aufrufen.

Die übliche Methode zum Implementieren dieser Funktion besteht darin, den Aufruf an die IOleAdviseHolder-Schnittstelle zu delegieren. Nur die pAdvise - und dwConnection-Member von STATDATA sind für IOleObject::EnumAdvise relevant.

Anforderungen

Weitere Informationen

IOleObject

IOleObject::Advise

IOleObject::Unadvise