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

Статья
08/24/2023

Функция GetTcp6Table2 извлекает таблицу tcp-подключений для IPv6.

Синтаксис

IPHLPAPI_DLL_LINKAGE ULONG GetTcp6Table2(
  [out]     PMIB_TCP6TABLE2 TcpTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Параметры

[out] TcpTable

Указатель на буфер, который получает таблицу TCP-подключений для IPv6 в качестве структуры MIB_TCP6TABLE2 .

[in, out] SizePointer

На входных данных указывает размер буфера, на который указывает параметр TcpTable .

На выходе, если буфер недостаточно велик для хранения возвращаемой таблицы TCP-подключений, функция устанавливает этот параметр равным требуемому размеру буфера.

[in] Order

Значение типа , указывающее, следует ли отсортировать таблицу tcp-подключений. Если этот параметр имеет значение TRUE, таблица сортируется по возрастанию, начиная с самого низкого локального IP-адреса. Если этот параметр имеет значение FALSE, таблица отображается в том порядке, в котором они были получены.

При упорядочении конечных точек TCP сравниваются следующие значения (как указано в списке):

Локальный IPv6-адрес
Идентификатор локального область
Локальный порт
Удаленный IPv6-адрес
Идентификатор удаленного область
Удаленный порт

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

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

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

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

Требования


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