RtlEthernetAddressToStringA 函数 （ip2string.h）

RtlEthernetAddressToString 函数将二进制以太网地址转换为以太网 MAC 地址的字符串表示形式。

语法

NTSYSAPI PSTR RtlEthernetAddressToStringA(
  [in]  const DL_EUI48 *Addr,
  [out] PSTR           S
);

参数

[in] Addr

采用二进制格式的以太网地址。 以太网地址按网络顺序排列（按从左到右排序的字节数）。

[out] S

指向缓冲区的指针，用于存储以太网地址的 NULL终止字符串表示形式。 此缓冲区应足够大，可以容纳至少 18 个字符。

返回值

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

言论

RtlEthernetAddressToString 函数用于将二进制以太网地址转换为以太网地址在以太网 EUI-48 数据链路层地址格式（也称为 MAC 地址）中的字符串表示形式。 该字符串表示以非 DIX 标准“-''表示法表示的数字以太网地址。

S 参数中返回的字符串以非 DIX 标准“-”表示法中的以太网 MAC 地址字符串的形式表示。 以太网 MAC 地址的基本字符串表示形式由短划线分隔的 6 对十六进制数字（例如 F4-CE-46-2D-90-8C）组成。

RtlEthernetAddressToString 是一个便利函数，它不需要加载 Windows 套接字 DLL 以访问 Windows 套接字中提供的函数以执行字符串到以太网地址转换。

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

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

DL_EUI48 数据类型在 Mstcpip.h 头文件中定义。

注意

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

要求

要求	价值
最低支持的客户端	Windows 7 [桌面应用 |UWP 应用]
支持的最低服务器	Windows Server 2008 R2 [桌面应用 |UWP 应用]
目标平台	窗户
标头	ip2string.h（包括 Mstcpip.h、Ip2string.h）
库	ntdll.lib
DLL	ntdll.dll

另请参阅

RtlEthernetStringToAddress