Método IEnumConnections::Next (ocidl.h)
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) |