inet_ntoa 函数 (winsock.h)

项目
03/04/2024

inet_ntoa 函数将 internet 网络地址) (Ipv4 转换为 Internet 标准点十进制格式的 ASCII 字符串。

语法

char * inet_ntoa(
  in_addr in
);

参数

in

TBD

返回值

如果未发生错误， inet_ntoa 返回指向静态缓冲区的字符指针，该缓冲区包含标准“.”中的文本地址符号。否则，它将返回 NULL。

注解

inet_ntoa函数采用由 in 参数指定的 Internet 地址结构，并返回一个以 NULL 结尾的 ASCII 字符串，该字符串表示“.”中的地址， (点) 表示法，如“192.168.16.0”中所示，这是以点数十进制表示法表示的 IPv4 地址的示例。 inet_ntoa返回的字符串驻留在 Windows 套接字分配的内存中。应用程序不应对内存的分配方式做出任何假设。保证返回的字符串仅在同一线程中进行下一次 Windows 套接字函数调用之前有效。因此，应在执行另一个 Windows 套接字调用之前复制数据。

WSAAddressToString 函数可用于将包含 IPv4 地址的 sockaddr 结构转换为 Internet 标准点十进制表示法中 IPv4 地址的字符串表示形式。 WSAAddressToString 函数的优点是它支持 IPv4 和 IPv6 地址。 WSAAddressToString 函数的另一个优点是此函数同时存在 ASCII 和 Unicode 版本。

在 Windows Vista 及更高版本上， RtlIpv4AddressToString 函数可用于将表示为 IN_ADDR 结构的 IPv4 地址转换为 Internet 标准点十进制表示法中 IPv4 地址的字符串表示形式。在 Windows Vista 及更高版本上，可以使用 RtlIpv6AddressToString 函数将表示为 IN6_ADDR 结构的 IPv6 地址转换为 IPv6 地址的字符串表示形式。

Windows Phone 8：Windows Phone 8 及更高版本上的 Windows Phone 应用商店应用支持此函数。

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

要求

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