Freigeben über


IConnectionPointContainer::EnumConnectionPoints-Methode (ocidl.h)

Erstellt ein Enumeratorobjekt, das alle im verbindungsfähigen Objekt unterstützten Verbindungspunkte durchlaufen soll, einen Verbindungspunkt pro ausgehender IID.

Syntax

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

Parameter

[out] ppEnum

Ein Zeiger auf eine IEnumConnectionPoints-Schnittstellenzeigervariable , die den Zeiger auf den neu erstellten Enumerator empfängt.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Das Enumeratorobjekt wurde erfolgreich erstellt.
E_POINTER
Die Adresse in ppEnum ist ungültig. Es kann z. B. NULL sein.

Hinweise

Da IEnumConnectionPoints Zeiger auf IConnectionPoint aufzählt, muss der Aufrufer IConnectionPoint::GetConnectionInterface verwenden, um den Schnittstellenbezeichner der ausgehenden Schnittstelle zu bestimmen, die der Verbindungspunkt unterstützt.

Hinweise für Anrufer

Der Aufrufer ist für den Aufruf von Release verantwortlich, wenn der Enumerator nicht mehr benötigt wird.

Hinweise zu Implementierern

Die Rückgabe E_NOTIMPL ist ausdrücklich nicht zulässig, da es mit Ausnahme von Typinformationen keine andere Möglichkeit gäbe, über die ein Aufrufer die IIDs der ausgehenden Schnittstellen finden könnte. Da ein anschließbares Objekt in der Regel über einen festen Satz bekannter ausgehender Schnittstellen verfügt, ist es einfach, den Enumerator zusätzlich zu einem zur Kompilierzeit bekannten Array von IIDs mit fester Länge zu implementieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IConnectionPointContainer

IEnumConnectionPoints