IEnumAgentHandler ::Next, méthode (tapi3.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.

Syntaxe

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

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers les interfaces ITAgentHandler .

[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 IEnumAgentHandler retournée par IEnumAgentHandler ::Next. L’application doit appeler Release sur l’interface IEnumAgentHandler pour libérer les ressources qui lui sont associées.

Configuration requise

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

Voir aussi

IEnumAgentHandler

Partager via