Compartilhar via

Método IEnumParticipant::Next

  • Artigo

[Avançar não está disponível para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]

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

Parâmetros

celt [in]

Número de elementos solicitados.

ppElements [out]

Ponteiro para interfaces ITAgentHandler .

pceltFetched [out]

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

Valor retornado

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 ITAgentHandler retornada por IEnumParticipant::Next. O aplicativo deve chamar Release na interface ITAgentHandler para liberar recursos associados a ele.

Requisitos

Requisito Valor
Versão do TAPI
 Requer TAPI 3.0 ou posterior
Cabeçalho
Confpriv.h
Biblioteca
Uuid.lib
DLL
Tapi3.dll

Confira também

IEnumParticipant

ITParticipant