FreeAddrInfoExW 函数 (ws2tcpip.h)
FreeAddrInfoEx 函数释放 GetAddrInfoEx 函数在 addrinfoex 结构中动态分配的地址信息。
语法
void WSAAPI FreeAddrInfoExW(
[in] PADDRINFOEXW 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.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 应用] |
目标平台 | Windows |
标头 | ws2tcpip.h |
Library | Ws2_32.lib |
DLL | Ws2_32.dll |