Поделиться через


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

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

Синтаксис

void WSAAPI FreeAddrInfoEx(
  [in] PADDRINFOEXA pAddrInfoEx
);

Параметры

[in] pAddrInfoEx

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

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

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

Комментарии

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

При определении ЮНИКОДа или _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 и более поздних версий.

Требования

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

См. также раздел

GetAddrInfoEx

addrinfoex