Поделиться через


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

Функция RasGetLinkStatistics извлекает собранную статистику по указанной ссылке в многолинейном соединении RAS.

Синтаксис

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

Параметры

[in] hRasConn

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

[in] dwSubEntry

Указывает вложенную вложенную вложенную ссылку, для которой требуется получить статистику.

[in, out] lpStatistics

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

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

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

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

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

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

Значение Значение
E_INVALID_ARG
Верно хотя бы одно из следующих значений: параметр hRasConn равен нулю, параметр dwSubEntry равен нулю, параметр 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

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

RasClearLinkStatistics

Rasdial

RasEnumConnections

RasGetConnectionStatistics

Общие сведения о службе удаленного доступа (RAS)

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