Método IEnumConnections::Next (ocidl.h)

  • Artigo

Recupera o número especificado de itens na sequência de enumeração.

Sintaxe

HRESULT Next(
  [in]  ULONG         cConnections,
  [out] LPCONNECTDATA rgcd,
  [out] ULONG         *pcFetched
);

Parâmetros

[in] cConnections

O número de itens a serem recuperados. Se houver menos do que o número solicitado de itens restantes na sequência, esse método recuperará os elementos restantes.

[out] rgcd

Uma matriz de itens enumerados.

O enumerador é responsável por alocar qualquer memória e o chamador é responsável por liberá-la. Se celt for maior que 1, o chamador também deverá passar um ponteiro não NULL passado para pceltFetched para saber quantos ponteiros liberar.

[out] pcFetched

O número de itens que foram recuperados. Esse parâmetro é sempre menor ou igual ao número de itens solicitados.

Retornar valor

Se o método recuperar o número de itens solicitados, o valor retornado será S_OK. Caso contrário, será S_FALSE.

Comentários

Depois que esse método retorna com êxito, o chamador é responsável por chamar Release (consulte o membro pUnk de CONNECTDATA) para cada elemento na matriz. Se cConnections for maior que um, o chamador também deverá passar um ponteiro não NULL para lpcFetched para obter o número de ponteiros que precisa ser liberado.

E_NOTIMPL não é permitido como um valor retornado. Se um valor de erro for retornado, nenhuma entrada na matriz será válida na saída e, portanto, nenhuma versão será necessária.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho ocidl.h (inclua ObjIdl.h)

Confira também

CONNECTDATA

Ienumconnections