Método IEnumConnections::Next (ocidl.h)
Recupera el número especificado de elementos de la secuencia de enumeración.
Sintaxis
HRESULT Next(
[in] ULONG cConnections,
[out] LPCONNECTDATA rgcd,
[out] ULONG *pcFetched
);
Parámetros
[in] cConnections
Número de elementos que se van a recuperar. Si hay menos del número solicitado de elementos que quedan en la secuencia, este método recupera los elementos restantes.
[out] rgcd
Matriz de elementos enumerados.
El enumerador es responsable de asignar cualquier memoria y el autor de la llamada es responsable de liberarla. Si celt es mayor que 1, el autor de la llamada también debe pasar un puntero que no sea NULL pasado a pceltFetched para saber cuántos punteros se van a liberar.
[out] pcFetched
Número de elementos recuperados. Este parámetro siempre es menor o igual que el número de elementos solicitados.
Valor devuelto
Si el método recupera el número de elementos solicitados, el valor devuelto se S_OK. De lo contrario, es S_FALSE.
Comentarios
Una vez que este método se devuelve correctamente, el autor de la llamada es responsable de llamar a Release (vea el miembro pUnk de CONNECTDATA) para cada elemento de la matriz. Si cConnections es mayor que uno, el autor de la llamada también debe pasar un puntero distinto de NULL a lpcFetched para obtener el número de punteros que debe liberar.
E_NOTIMPL no se permite como valor devuelto. Si se devuelve un valor de error, no hay entradas en la matriz válidas al salir y, por lo tanto, no se requiere ninguna versión.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | ocidl.h (incluya ObjIdl.h) |