Méthode IEnumConnections ::Next (ocidl.h)

Article
02/29/2024

Récupère le nombre spécifié d’éléments dans la séquence d’énumération.

Syntaxe

HRESULT Next(
  [in]  ULONG         cConnections,
  [out] LPCONNECTDATA rgcd,
  [out] ULONG         *pcFetched
);

Paramètres

[in] cConnections

Nombre d’éléments à récupérer. S’il reste moins que le nombre d’éléments demandé dans la séquence, cette méthode récupère les éléments restants.

[out] rgcd

Tableau d’éléments énumérés.

L’énumérateur est responsable de l’allocation de la mémoire et l’appelant est chargé de la libérer. Si celt est supérieur à 1, l’appelant doit également passer un pointeur non NULL passé à pceltFetched pour connaître le nombre de pointeurs à libérer.

[out] pcFetched

Nombre d’éléments récupérés. Ce paramètre est toujours inférieur ou égal au nombre d’éléments demandés.

Valeur retournée

Si la méthode récupère le nombre d’éléments demandés, la valeur de retour est S_OK. Sinon, c’est S_FALSE.

Remarques

Une fois cette méthode retournée, l’appelant est responsable de l’appel de Release (voir le membre pUnk de CONNECTDATA) pour chaque élément du tableau. Si cConnections est supérieur à un, l’appelant doit également passer un pointeur non NULL à lpcFetched pour obtenir le nombre de pointeurs qu’il doit libérer.

E_NOTIMPL n’est pas autorisé en tant que valeur de retour. Si une valeur d’erreur est retournée, aucune entrée du tableau n’est valide lors de la sortie. Par conséquent, aucune mise en production n’est requise.

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 (inclure ObjIdl.h)

Voir aussi

CONNECTDATA

IEnumConnections