IEnumAgent::Next, méthode (tapi3.h)

Article
08/26/2023

La méthode Next obtient le nombre d’éléments spécifié suivant dans la séquence d’énumération.

Syntaxe

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

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers le pointeur ITAgent .

[out] pceltFetched

Pointeur vers le nombre d’éléments réellement fournis. Peut être NULL si le celte est un.

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a retourné 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 ITAgent retournée par IEnumAgent::Next. L’application doit appeler Release sur l’interface ITAgent pour libérer les ressources qui lui sont associées.

Configuration requise


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

Voir aussi

IEnumAgent

ITAgent

Partager via