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

Статья
11/20/2024

Функция FreeAddrInfoW освобождает сведения об адресе, которые функция GetAddrInfoW динамически выделяется в структурах addrinfoW.

Синтаксис

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Параметры

[in] pAddrInfo

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

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

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

Замечания

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

Макросы в файле заголовка Winsock определяют имя функции смешанного регистра FreeAddrInfo и структуру ADDRINFOT. Эту функцию FreeAddrInfo следует вызывать с параметром pAddrInfo указателя типа ADDRINFOT. При определении ЮНИКОДа или _UNICODE FreeAddrInfo определяется как FreeAddrInfoW, версия Юникода функции и ADDRINFOT определяется в структуре addrinfoW. Если юникод или _UNICODE не определен, FreeAddrInfo определяется как freeaddrinfo, версия ANSI функции и ADDRINFOT определена в структуре addrinfo.

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

Заметка

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

Требования

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