Méthode IEnumLocation ::Next (tapi3if.h)

Article
03/02/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] ITLocationInfo **ppElements,
  [out] ULONG          *pceltFetched
);

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers le pointeur ITLocationInfo .

[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 ITLocationInfo retournée par IEnumLocation ::Next. L’application doit appeler Release sur l’interface ITLocationInfo 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

Partager via