Функция FreeAddrInfoExW (ws2tcpip.h)

Функция FreeAddrInfoEx освобождает сведения об адресе, которые функция GetAddrInfoEx динамически выделяется в структурах addrinfo ex .

Синтаксис

void WSAAPI FreeAddrInfoExW(
  [in] PADDRINFOEXW pAddrInfoEx
);

Параметры

[in] pAddrInfoEx

Указатель на структуру addrinfoex или связанный список структур addrinfoex, которые необходимо освободить. Все динамическое хранилище, указывающее на addrinfoex структура или структуры, также освобождается.

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

Эта функция не возвращает значение.

Замечания

Функция FreeAddrInfoEx освобождает структуры addrinfoex динамически выделяется функцией GetAddrInfoEx. Функция FreeAddrInfoEx освобождает начальную структуру addrinfoex, указываемую на параметр pAddrInfo, включая буферы, в которые точки элементов структуры, затем продолжает освобождать все структуры addrinfoex, связанные с элементом ai_next структуры addrinfoex. Функция FreeAddrInfoEx продолжает освобождать связанные структуры до тех пор, пока не будет обнаружен элемент NULLai_next.

При определении ЮНИКОДа или _UNICODE FreeAddrInfoEx определяется как FreeAddrInfoExW, версия Юникода функции и ADDRINFOEX определяется в структуре addrinfoexW. Если юникод или _UNICODE не определен, FreeAddrInfoEx определяется как FreeAddrInfoExA, версия ANSI функции и ADDRINFOEX определяется для структуры addrinfoexA.

Windows 8.1 и Windows Server 2012 R2: функция FreeAddrInfoExW поддерживается для приложений Магазина Windows в Windows 8.1, Windows Server 2012 R2 и более поздних версий.

Заметка

Заголовок ws2tcpip.h определяет FreeAddrInfoEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8.1, Windows Vista [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2008 [классические приложения | Приложения UWP]
целевая платформа	Виндоус
заголовка	ws2tcpip.h
библиотеки	Ws2_32.lib
DLL	Ws2_32.dll

См. также

GetAddrInfoEx

addrinfoex