IEnumTerminal ::Next, méthode (tapi3if.h)

Article
03/04/2024

La méthode Next obtient le nombre d’éléments spécifié suivant dans la séquence d’énumération. Cette méthode est masquée dans Visual Basic et les langages de script.

Syntaxe

HRESULT Next(
  [in]  ULONG      celt,
  [out] ITTerminal **ppElements,
  [out] ULONG      *pceltFetched
);

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers ITTerminal pointers retournés.

[out] pceltFetched

Pointeur vers le nombre d’éléments réellement fournis. Peut avoir la valeur NULL si celte en est un.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a renvoyé le nombre d’éléments celtes .
S_FALSE	Le nombre d’éléments restants était inférieur au celte.
E_POINTER	Le paramètre ppElements n’est pas un pointeur valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.

Remarques

TAPI appelle la méthode AddRef sur l’interface ITTerminal retournée par IEnumTerminal ::Next. L’application doit appeler Release sur l’interface ITTerminal pour libérer les ressources qui lui sont associées.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi3if.h (inclure Tapi3.h)
Bibliothèque	Uuid.lib
DLL	Tapi3.dll

Voir aussi

Objet Terminal

Partager via