Функция 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.
Значение | Значение |
---|---|
|
Верно хотя бы одно из следующих значений: параметр hRasConn равен нулю, параметр lpStatistics имеет значение NULL или значение, заданное членом dwSizeструктуры RAS_STATS , указывает версию структуры, которая не поддерживается используемой операционной системой. |
|
Функции не удалось выделить достаточный объем памяти для завершения операции. |
|
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки. |
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | ras.h |
Библиотека | Rasapi32.lib |
DLL | Rasapi32.dll |