freeaddrinfo 函数 (ws2tcpip.h)

项目
03/13/2024

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