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

Статья
08/28/2023

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

Синтаксис

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

Параметры

[in] pAddrInfo

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

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

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

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

Макросы в файле заголовка 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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