Функция GetTcp6Table2 (iphlpapi.h)
Функция 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.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
| Код возврата | Описание |
|---|---|
|
Буфер, на который указывает параметр TcpTable, недостаточно велик. Требуемый размер возвращается в переменной, на которую указывает параметр SizePointer . |
|
Параметр SizePointer имеет значение NULL, или GetTcp6Table2 не может выполнить запись в память, на которую указывает параметр SizePointer . |
|
Эта функция не поддерживается в операционной системе, используемой в локальной системе. |
|
Используйте FormatMessage , чтобы получить строку сообщения для возвращенной ошибки. |
Комментарии
Функция GetTcp6Table2 определена в Windows Vista и более поздних версиях.
Функция GetTcp6Table2 — это расширенная версия функции GetTcp6Table , которая также получает сведения о состоянии разгрузки TCP для TCP-подключения.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | iphlpapi.h |
| Библиотека | Iphlpapi.lib |
| DLL | Iphlpapi.dll |