freeaddrinfo 函数 (ws2tcpip.h)
freeaddrinfo 函数释放 getaddrinfo 函数在 addrinfo 结构中动态分配的地址信息。
语法
VOID WSAAPI freeaddrinfo(
[in] PADDRINFOA pAddrInfo
);
参数
[in] pAddrInfo
指向要释放的 addrinfo 结构的 addrinfo 结构的指针或链接列表。 同时释放 指向 addrinfo 结构或结构中的所有动态存储。
返回值
此函数不返回值。
注解
freeaddrinfo 函数释放由 ANSI getaddrinfo 函数动态分配的 addrinfo 结构。 freeaddrinfo 函数释放 ai 参数中指向的初始 addrinfo 结构（包括结构成员指向的任何缓冲区），然后继续释放由 addrinfo 结构的 ai_next 成员链接的任何 addrinfo 结构。 freeaddrinfo 函数继续释放链接结构，直到遇到 NULLai_next 成员。
Winsock 头文件中的宏定义 FreeAddrInfo 和 ADDRINFOT 结构的混合大小写函数名称。 应使用 ADDRINFOT 类型的指针的 ai 参数调用此 FreeAddrInfo 函数。 如果未定义 UNICODE 或 _UNICODE， 则 FreeAddrInfo 定义为 freeaddrinfo、函数的 ANSI 版本，而 ADDRINFOT 则定义为 addrinfo 结构。 定义 UNICODE 或 _UNICODE 时， FreeAddrInfo 定义为 FreeAddrInfoW，函数的 Unicode 版本， ADDRINFOT 定义为 addrinfoW 结构。
在早期版本的 Windows 上支持 freeaddrinfo
freeaddrinfo 函数已添加到 Windows XP 及更高版本的 Ws2_32.dll。FreeAddrInfoW 函数是 freeaddrinfo 的 Unicode 版本。 FreeAddrInfoW 函数已添加到 Windows XP 中的 Ws2_32.dll 中，Service Pack 2 (SP2) 。 FreeAddrInfoW 函数不能在早于 SP2 的 Windows XP 版本上使用。
Windows Phone 8：Windows Phone 8 及更高版本上的 Windows Phone Store 应用支持 freeaddrinfo 函数。
Windows 8.1和Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持 freeaddrinfo 和 FreeAddrInfoW 函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8.1，Windows Vista [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2003 [桌面应用 | UWP 应用] |
| 目标平台 | Windows |
| 标头 | ws2tcpip.h |
| DLL | Ws2_32.dll |