Méthode IConnectionPointContainer ::EnumConnectionPoints (ocidl.h)
Crée un objet énumérateur pour itérer à travers tous les points de connexion pris en charge dans l’objet connectable, un point de connexion par ID sortant.
Syntaxe
HRESULT EnumConnectionPoints(
[out] IEnumConnectionPoints **ppEnum
);
Paramètres
[out] ppEnum
Pointeur vers une variable de pointeur d’interface IEnumConnectionPoints qui reçoit le pointeur vers l’énumérateur nouvellement créé.
Valeur retournée
Cette méthode peut retourner les valeurs de retour standard E_OUTOFMEMORY et E_UNEXPECTED, ainsi que les valeurs suivantes.
Code de retour | Description |
---|---|
|
L’objet énumérateur a été créé avec succès. |
|
L’adresse dans ppEnum n’est pas valide. Par exemple, il peut être NULL. |
Remarques
Étant donné que IEnumConnectionPoints énumère des pointeurs vers IConnectionPoint, l’appelant doit utiliser IConnectionPoint ::GetConnectionInterface pour déterminer l’identificateur d’interface de l’interface sortante prise en charge par le point de connexion.
Notes aux appelants
L’appelant est responsable d’appeler Release lorsque l’énumérateur n’est plus nécessaire.Notes aux implémenteurs
Le retour E_NOTIMPL est spécifiquement interdit, car, à l’exception des informations de type, il n’y aurait aucun autre moyen par lequel un appelant pourrait trouver les ID des interfaces sortantes. Étant donné qu’un objet connectable a généralement un ensemble fixe d’interfaces sortantes connues, il est simple d’implémenter l’énumérateur sur un tableau d’ID de longueur fixe connu au moment de la compilation.Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
Plateforme cible | Windows |
En-tête | ocidl.h |