通过

RtlEthernetStringToAddressA 函数 （ip2string.h）

  • 项目

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

语法

NTSYSAPI NTSTATUS RtlEthernetStringToAddressA(
  [in]  PCSTR    S,
  [out] PCSTR    *Terminator,
  [out] DL_EUI48 *Addr
);

参数

[in] S

指向缓冲区的指针，其中包含以太网 MAC 地址的 NULL终止字符串表示形式。

[out] Terminator

一个参数，该参数接收指向终止转换字符串的字符的指针。 调用方可以使用此方法从字符串中提取更多信息。

[out] Addr

一个指针，其中存储以太网 MAC 地址的二进制表示形式。

返回值

如果函数成功，则返回值 STATUS_SUCCESS。

如果函数失败，则返回值为以下错误代码之一。

返回代码 描述
STATUS_INVALID_PARAMETER
 将无效参数传递给函数。 如果 S 参数指向的字符串不包含以太网 MAC 地址的正确字符串表示形式，则返回此错误。

此错误代码在 Ntstatus.h 头文件中定义。
其他
 使用 FormatMessage 获取返回错误的消息字符串。

言论

RtlEthernetStringToAddress 函数用于将以太网 EUI-48 数据链路层地址（也称为 MAC 地址）的字符串表示形式转换为以太网地址的二进制格式。 该字符串表示以非 DIX 标准“-''表示法表示的数字以太网地址。 返回的值是一个适合用作以太网地址的数字。 所有以太网地址按网络顺序返回（按从左到右排序的字节数）。

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

成功后，终止符 参数指向终止已转换字符串的字符。 这允许应用程序将包含以太网地址的字符串以及附加信息传递给 RtlEthernetStringToAddress 函数，然后分析其余信息。

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

定义 UNICODE 或_UNICODE时，RtlEthernetStringToAddress 定义为 RtlEthernetStringToAddressW（此函数的 Unicode 版本）。 S 和 终止符 参数定义为 PCWSTR 数据类型。

如果未定义 UNICODE 和_UNICODE，则 RtlEthernetStringToAddress 定义为 RtlEthernetStringToAddressA（此函数的 ANSI 版本）。 S 和 终止符 参数定义为 PCSTR 数据类型。

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

注意

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

要求

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

另请参阅

RtlEthernetAddressToString