Partager via


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

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

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers le pointeur ITCallingCard .

[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.

Code de retour Description
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 ITCallingCard retournée par IEnumCallingCard ::Next. L’application doit appeler Release sur l’interface ITCallingCard 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

Terminal, objet