Share via

Méthode IConnectionPointContainer ::EnumConnectionPoints (ocidl.h)

  • Article

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
S_OK
 L’objet énumérateur a été créé avec succès.
E_POINTER
 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

Voir aussi

IConnectionPointContainer

IEnumConnectionPoints