Metodo IEnumAddress::Next (tapi3if.h)

  • Articolo

Il metodo Next ottiene il numero specificato successivo di elementi nella sequenza di enumerazione. Questo metodo è nascosto da Visual Basic e dai linguaggi di scripting.

Sintassi

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

Parametri

[in] celt

Numero di elementi richiesti.

[out] ppElements

Puntatore al puntatore ITAddress .

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

Codice restituito Descrizione
S_OK
 Il metodo ha restituito il numero di elementi celt .
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 ITAddress restituita da questo metodo. L'applicazione deve chiamare Release nell'interfaccia ITAddress per liberare le risorse associate.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi3if.h (include Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

IEnumAddress

ITAddress