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 |
|---|---|
|
Das Enumeratorobjekt wurde erfolgreich erstellt. |
|
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 |