Функция 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