通过

FreeAddrInfoExW 函数 （ws2tcpip.h）

  • 项目

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

语法

void WSAAPI FreeAddrInfoExW(
  [in] PADDRINFOEXW pAddrInfoEx
);

参数

[in] pAddrInfoEx

指向要释放的 addrinfoex 结构或 addrinfoex 结构的链接列表的指针。 addrinfoex 结构或结构内指向的所有动态存储也将释放。

返回值

此函数不返回值。

言论

FreeAddrInfoEx 函数释放 addrinfoex 结构，GetAddrInfoEx 函数动态分配。 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.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本上的 Windows 应用商店应用支持 FreeAddrInfoExW 函数。

注意

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

要求

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

另请参阅

GetAddrInfoEx

addrinfoex