Función RasGetLinkStatistics (ras.h)

La función RasGetLinkStatistics recupera estadísticas acumuladas para el vínculo especificado en una conexión de varios vínculos RAS.

Sintaxis

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

[in] hRasConn

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

[in] dwSubEntry

Especifica el subentry que corresponde al vínculo para el que se van a recuperar las estadísticas.

[in, out] lpStatistics

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

En la entrada, el miembro dwSize de esta estructura especifica el tamaño de RAS_STATS. Use sizeof(RAS_STATS) para obtener este tamaño.

Este parámetro no puede ser NULL.

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_INVALID_ARG	Al menos uno de los siguientes valores es true: el parámetro hRasConn es cero, el parámetro dwSubEntry 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 admite 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.

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