FreeAddrInfoW 函数 (ws2tcpip.h)

FreeAddrInfoW 函数释放 GetAddrInfoW 函数在 addrinfoW 结构中动态分配的地址信息。

语法

VOID WSAAPI FreeAddrInfoW(
  [in] PADDRINFOW pAddrInfo
);

参数

[in] pAddrInfo

指向要释放的 addrinfoW 结构的 addrinfoW 结构或链接列表的指针。 同时释放 addrinfoW 结构或结构中指向的所有动态存储。

返回值

此函数不返回值。

注解

FreeAddrInfoW 函数释放由 Unicode GetAddrInfoW 函数动态分配的 addrinfoW 结构。 FreeAddrInfoW 函数释放 pAddrInfo 参数中指向的初始 addrinfoW 结构，包括结构成员指向的任何缓冲区，然后继续释放由 addrinfoW 结构的 ai_next 成员链接的任何 addrinfoW 结构。 FreeAddrInfoW 函数继续释放链接结构，直到遇到 NULLai_next 成员。

Winsock 头文件中的宏定义 FreeAddrInfo 的混合大小写函数名称和 ADDRINFOT 结构。 应使用 ADDRINFOT 类型的指针的 pAddrInfo 参数调用此 FreeAddrInfo 函数。 定义 UNICODE 或 _UNICODE 时， FreeAddrInfo 定义为 FreeAddrInfoW，函数的 Unicode 版本， ADDRINFOT 定义为 addrinfoW 结构。 如果未定义 UNICODE 或 _UNICODE， 则会将 FreeAddrInfo 定义为 freeaddrinfo、函数的 ANSI 版本，并将 ADDRINFOT 定义为 addrinfo 结构。

Windows 8.1和Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。

注意

ws2tcpip.h 标头将 FreeAddrInfo 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 8.1、Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 | UWP 应用]
目标平台	Windows
标头	ws2tcpip.h
Library	Ws2_32.lib
DLL	Ws2_32.dll

另请参阅

GetAddrInfoW

Winsock 函数

addrinfo

addrinfoW

freeaddrinfo

getaddrinfo