Méthode IEnumConnections ::Next (ocidl.h)
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) |