Функция freeaddrinfo (ws2tcpip.h)
Функция 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 |