Función RasGetConnectionStatistics (ras.h)

La función RasGetConnectionStatistics recupera las estadísticas de conexión acumuladas para la conexión especificada.

Sintaxis

DWORD RasGetConnectionStatistics(
  [in]      HRASCONN  hRasConn,
  [in, out] RAS_STATS *lpStatistics
);

Parámetros

[in] hRasConn

Identificador de la conexión. Use RasDial o RasEnumConnections para obtener este identificador.

[in, out] lpStatistics

Puntero a la estructura RAS_STATS que, en la salida, recibe las estadísticas.

En la entrada, establezca el miembro dwSize de esta estructura en sizeof(RAS_STATS).

Este parámetro no puede ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error o un valor de Enrutamiento y códigos de error de acceso remoto o Winerror.h.

Valor Significado
E_INVALIDARG
Al menos uno de los siguientes valores es true: el parámetro hRasConn es cero, el parámetro lpStatistics es NULL o el valor especificado por el miembro dwSize de la estructura RAS_STATS especifica una versión de la estructura que no es compatible con el sistema operativo en uso.
ERROR_NOT_ENOUGH_MEMORY
La función no pudo asignar memoria suficiente para completar la operación.
Otros
Use FormatMessage para recuperar el mensaje de error del sistema que corresponde al código de error devuelto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ras.h
Library Rasapi32.lib
Archivo DLL Rasapi32.dll

Consulte también

RasClearConnectionStatistics

Rasdial

RasEnumConnections

RasGetLinkStatistics

Información general sobre el servicio de acceso remoto (RAS)

Funciones del Servicio de acceso remoto