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

  • Article

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

Paramètres

[in] celt

Nombre d’éléments demandés.

[out] ppElements

Pointeur vers les pointeurs ITStream retournés.

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

Voir aussi

IEnumStream

ITStream

Media Service Provider Interface (MSPI)