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

Статья
03/13/2024

Функция GetUdp6Table извлекает таблицу прослушивателя протокола UDP IPv6.

Синтаксис

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

Параметры

[out] Udp6Table

Указатель на буфер, который получает таблицу прослушивателя UDP IPv6 в виде структуры MIB_UDP6TABLE .

[in, out] SizePointer

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

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

[in] Order

Логическое значение, указывающее, следует ли сортировать возвращаемую таблицу прослушивателя UDP. Если этот параметр имеет значение TRUE, таблица сортируется в следующем порядке:

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

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

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

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

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

Требования

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