FreeAddrInfoEx 函数 (ws2tcpip.h)

FreeAddrInfoEx 函数释放 GetAddrInfoEx 函数在 addrinfoex 结构中动态分配的地址信息。

语法

void WSAAPI FreeAddrInfoEx(
  [in] PADDRINFOEXA pAddrInfoEx
);

参数

[in] pAddrInfoEx

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

返回值

此函数不返回值。

注解

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

定义 UNICODE 或 _UNICODE 时, FreeAddrInfoEx 定义为 FreeAddrInfoExW,函数的 Unicode 版本, ADDRINFOEX 定义为 addrinfoexW 结构。 如果未定义 UNICODE 或 _UNICODE, 则 FreeAddrInfoEx 定义为 FreeAddrInfoExA,函数的 ANSI 版本, ADDRINFOEX 将定义为 addrinfoexA 结构。

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

要求

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

另请参阅

GetAddrInfoEx

addrinfoex