IOleAdviseHolder::EnumAdvise-Methode (oleidl.h)

Artikel
03/01/2024

Erstellt einen Enumerator, der zum Auflisten der derzeit für ein Objekt eingerichteten Beratungsverbindungen verwendet werden kann.

Syntax

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

Parameter

[out] ppenumAdvise

Ein Zeiger auf eine IEnumSTATDATA-Zeigervariable , die den Schnittstellenzeiger auf den neuen Enumerator empfängt. Wenn dieser Parameter NULL ist, gibt es derzeit keine Empfehlungsverbindungen für das Objekt, oder es ist ein Fehler aufgetreten. Der Berater ist für die Erhöhung der Referenzanzahl auf dem IEnumSTATDATA-Zeiger verantwortlich, den diese Methode bereitstellt. Es liegt in der Verantwortung des Aufrufers , IUnknown::Release aufzurufen, wenn es mit dem Zeiger abgeschlossen ist.

Rückgabewert

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

Rückgabecode	Beschreibung
E_FAIL	Fehler beim Enumerationsvorgang.
E_NOTIMPL	IOleAdviseHolder::EnumAdvise ist nicht implementiert.

Hinweise

IOleAdviseHolder::EnumAdvise erstellt einen Enumerator, der verwendet werden kann, um die eingerichteten Beratungsverbindungen eines Objekts aufzulisten. Die -Methode stellt einen Zeiger auf die IEnumSTATDATA-Schnittstelle in diesem Enumerator bereit. Verbindungsinformationen für jede Verbindung werden in der STATDATA-Struktur gespeichert, und der Enumerator muss in der Lage sein, diese Strukturen aufzulisten.

Für diese Methode sind die einzigen relevanten Strukturmember pAdvise und dwConnection. Andere Member enthalten Datenempfehlungsinformationen. Wenn Sie die Enumerationsmethoden aufrufen und während eine Enumeration ausgeführt wird, ist die Auswirkung des Registrierens oder Aufhebens von Beratungsverbindungen auf das, was aufgelistet werden soll, nicht definiert.

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