Método IEnumParticipant::Next

[O Next não está disponível para uso em 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 das linguagens de Visual Basic e 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 o 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 de celt .
S_FALSE
O número de elementos restantes foi menor que o celt.
E_POINTER
O parâmetro ppElements não é um ponteiro válido.
E_OUTOFMEMORY
A memória insuficiente existe 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