Функция GetTcpStatisticsEx (iphlpapi.h)

Статья
08/24/2023

Функция GetTcpStatisticsEx извлекает статистику протокола TCP для текущего компьютера. Функция GetTcpStatisticsEx отличается от функции GetTcpStatistics тем, что GetTcpStatisticsEx также поддерживает семейство протоколов IPv6.

Синтаксис

IPHLPAPI_DLL_LINKAGE ULONG GetTcpStatisticsEx(
  [out] PMIB_TCPSTATS Statistics,
  [in]  ULONG         Family
);

Параметры

[out] Statistics

Указатель на структуру MIB_TCPSTATS , которая получает статистику TCP для локального компьютера.

[in] Family

Семейство протоколов, для которого требуется получить статистику. Этот параметр должен иметь одно из следующих значений:

Значение	Значение
AF_INET	Протокол IP версии 4 (IPv4).
AF_INET6	Протокол IPv6.

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

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Параметр pStats имеет значение NULL или не указывает на допустимую память, или параметр dwFamily не является допустимым значением.
ERROR_NOT_SUPPORTED	Эта функция не поддерживается в операционной системе, в которой был выполнен вызов функции.
Другое	Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	iphlpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll