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:
| Rückgabecode | Beschreibung |
|---|---|
|
IOleObject::EnumAdvise ist nicht implementiert. |
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
| 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 |