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

Статья
08/28/2023

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

Синтаксис

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

Параметры

[in] pAddrInfo

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

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

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

Функция freeaddrinfo освобождает структуры addrinfo , динамически выделяемые функцией ANSI getaddrinfo . Функция freeaddrinfo освобождает начальную структуру addrinfo , указанную в параметре ai , включая все буферы, на которые указывают члены структуры, а затем продолжает освобождать все структуры addrinfo , связанные ai_next элементом структуры addrinfo . Функция freeaddrinfo продолжает освобождать связанные структуры до тех пор, пока не будет обнаружен элемент null ai_next.

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

Поддержка freeaddrinfo в более ранних версиях Windows

Функция freeaddrinfo была добавлена в Ws2_32.dll в Windows XP и более поздних версиях.

Функция FreeAddrInfoW — это версия freeaddrinfo в Юникоде. Функция FreeAddrInfoW была добавлена в Ws2_32.dll в Windows XP с пакетом обновления 2 (SP2). Функцию FreeAddrInfoW нельзя использовать в версиях Windows, предшествующих Windows XP с пакетом обновления 2 (SP2).

Windows Phone 8. Функция freeaddrinfo поддерживается для приложений Магазина Windows Phone Windows Phone 8 и более поздних версий.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1, Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	ws2tcpip.h
DLL	Ws2_32.dll