RtlIpv4AddressToStringA 函数 (ip2string.h)

项目
08/24/2023

RtlIpv4AddressToString 函数将 IPv4 地址转换为 Internet 标准点十进制格式的字符串。

语法

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

参数

[in] Addr

按网络字节顺序排列的 IPv4 地址。

[out] S

指向缓冲区的指针，用于存储 IPv4 地址的 以 NULL 结尾的字符串表示形式。此缓冲区应足够大，至少包含 16 个字符。

返回值

指向在 IPv4 地址的字符串表示形式末尾插入的 NULL 字符的指针。调用方可以使用它轻松将更多信息追加到字符串。

注解

RtlIpv4AddressToString 函数用于将 IPv4 地址转换为 Internet 点十进制格式的 IPv4 地址的字符串表示形式。

RtlIpv4AddressToString 是一种便捷函数，它不需要加载 Windows 套接字 DLL 即可访问 Windows 套接字中提供的函数，以执行 IP 地址到字符串的转换。

定义 UNICODE 或 _UNICODE 时， RtlIpv4AddressToString 将定义为 RtlIpv4AddressToStringW（此函数的 Unicode 版本）。字符串参数 S 和函数返回值定义为 PWSTR 数据类型。

如果未定义 UNICODE 和 _UNICODE， 则 RtlIpv4AddressToString 将定义为 RtlIpv4AddressToString，即此函数的 ANSI 版本。字符串参数 S 和函数返回值定义为 PSTR 数据类型。

IN_ADDR结构在 Inaddr.h 头文件中定义。

包含 RtlIpv4AddressToString 函数的导入库不包含在针对 Windows Vista 发布的 Microsoft Windows 软件开发工具包 (SDK) 中。 RtlIpv4AddressToString 函数包含在 Windows 驱动程序工具包 (WDK) 中包含的 Ntdll.lib 导入库中。应用程序还可以使用 GetModuleHandle 和 GetProcAddress 函数从 Ntdll.dll 检索函数指针并调用此函数。

注意

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

要求


最低受支持的客户端	Windows Vista [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2008 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	ip2string.h (包括 Mstcpip.h、Ip2string.h)
Library	ntdll.lib
DLL	ntdll.dll