Функция RasGetConnectionStatistics (ras.h)

Функция RasGetConnectionStatistics извлекает собранную статистику подключения для указанного подключения.

Синтаксис

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

Параметры

[in] hRasConn

Дескриптор подключения. Используйте RasDial или RasEnumConnections для получения этого дескриптора.

[in, out] lpStatistics

Указатель на структуру RAS_STATS , которая в выходных данных получает статистику.

На входных данных задайте для элемента dwSize этой структуры значение sizeof(RAS_STATS).

Этот параметр не может иметь значение NULL.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.

Значение Значение
E_INVALIDARG
Верно хотя бы одно из следующих значений: параметр hRasConn равен нулю, параметр lpStatistics имеет значение NULL или значение, заданное членом dwSizeструктуры RAS_STATS , указывает версию структуры, которая не поддерживается используемой операционной системой.
ERROR_NOT_ENOUGH_MEMORY
Функции не удалось выделить достаточный объем памяти для завершения операции.
Другое
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ras.h
Библиотека Rasapi32.lib
DLL Rasapi32.dll

См. также раздел

RasClearConnectionStatistics

Rasdial

RasEnumConnections

RasGetLinkStatistics

Обзор службы удаленного доступа (RAS)

Функции службы удаленного доступа