inet_ntoa 函数 (winsock2.h)

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

语法

char *WSAAPI 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.1Windows Server 2012 R2:Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。

要求

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

另请参阅

IN6_ADDR

InetNtop

RtlIpv4AddressToString

RtlIpv4AddressToStringEx

RtlIpv4StringToAddress

RtlIpv4StringToAddressEx

RtlIpv6AddressToString

RtlIpv6AddressToStringEx

RtlIpv6StringToAddress

RtlIpv6StringToAddressEx

SOCKADDR

WSAAddressToString

Winsock 函数

Winsock 参考

in_addr

inet_addr