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

Consulte también

CONNECTDATA

IEnumConnections