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

  • Article

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]     ITPhone **ppElements,
  [in, out] ULONG   *pceltFetched
);

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers la liste itPhone des pointeurs retournés.

[in, 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_OUTOFMEMORY
 La mémoire est insuffisante pour effectuer l’opération.
E_POINTER
 Le paramètre ppElements n’est pas un pointeur valide.

Remarques

TAPI appelle la méthode AddRef sur l’interface ITPhone retournée par IEnumPhone ::Next. L’application doit appeler Release sur l’interface ITPhone 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

IEnumPhone

ITPhone