Método IEnumAddress::Next (tapi3if.h)

O método Next obtém o próximo número especificado de elementos na sequência de enumeração. Esse método está oculto do Visual Basic e das linguagens de script.

Sintaxe

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

Parâmetros

[in] celt

Número de elementos solicitados.

[out] ppElements

Ponteiro para o ponteiro ITAddress .

[out] pceltFetched

Ponteiro para o número de elementos realmente fornecidos. Pode ser NULL se celt for um.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método retornou o número de elementos celt .
S_FALSE	O número de elementos restantes era menor que celt.
E_POINTER	O parâmetro ppElements não é um ponteiro válido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.

Comentários

O TAPI chama o método AddRef na interface ITAddress retornada por esse método. O aplicativo deve chamar Release na interface ITAddress para liberar recursos associados a ele.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi3if.h (inclua Tapi3.h)
Biblioteca	Uuid.lib
DLL	Tapi3.dll

Confira também

IEnumAddress

ITAddress