Metodo IEnumAgent::Next (tapi3.h)

  • Articolo

Il metodo Next ottiene il numero specificato successivo di elementi nella sequenza di enumerazione.

Sintassi

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

Parametri

[in] celt

Numero di elementi richiesti.

[out] ppElements

Puntatore al puntatore ITAgent .

[out] pceltFetched

Puntatore al numero di elementi effettivamente forniti. Può essere NULL se celt è uno.

Valore restituito

Questo metodo può restituire uno di questi valori.

valore Significato
S_OK
 Metodo restituito numero di elementi.
S_FALSE
 Il numero di elementi rimanenti è minore di celt.
E_POINTER
 Il parametro ppElements non è un puntatore valido.
E_OUTOFMEMORY
 Memoria insufficiente per eseguire l'operazione.

Commenti

TAPI chiama il metodo AddRef nell'interfaccia ITAgent restituita da IEnumAgent::Next. L'applicazione deve chiamare Release nell'interfaccia ITAgent per liberare risorse associate.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione tapi3.h (includere Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

IEnumAgent

ITAgent