Функция RtlEthernetAddressToStringW (ip2string.h)

Статья
11/20/2024

Функция RtlEthernetAddressToString преобразует двоичный ethernet-адрес в строковое представление MAC-адреса Ethernet.

Синтаксис

NTSYSAPI PWSTR RtlEthernetAddressToStringW(
  [in]  const DL_EUI48 *Addr,
  [out] PWSTR          S
);

Параметры

[in] Addr

Адрес Ethernet в двоичном формате. Адрес Ethernet находится в порядке сети (байты, упорядоченные слева направо).

[out] S

Указатель на буфер, в котором хранится NULL-завершенное строковое представление адреса Ethernet. Этот буфер должен быть достаточно большим, чтобы содержать не менее 18 символов.

Возвращаемое значение

Указатель на символ NULL, вставленный в конце строкового представления MAC-адреса Ethernet. Это можно использовать вызывающим методом для легкого добавления дополнительных сведений в строку.

Замечания

Функция RtlEthernetAddressToString используется для преобразования двоичного адреса Ethernet в строковое представление адреса Ethernet в формате ip-адресов в формате слоя канала данных Ethernet EUI-48 (также известный как MAC-адрес). Строка представляет числовый адрес Ethernet, выраженный в стандартной нотации "-'".

Строка, возвращаемая в параметре S, представлена в виде строки MAC-адреса Ethernet в нотации, отличной от DIX, стандартной нотации "-". Базовое строковое представление MAC-адреса Ethernet состоит из 6 пар шестнадцатеричных чисел, разделенных дефисами (например, F4-CE-46-2D-90-8C).

RtlEthernetAddressToString — это удобная функция, которая не требует загрузки библиотеки DLL сокетов Windows для доступа к функции, предоставленной в сокетах Windows для выполнения преобразования строк в адрес Ethernet.

При определении ЮНИКОДа или _UNICODE RtlEthernetAddressToString определяется как RtlEthernetAddressToStringW, версия Юникода этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PWSTR.

Если _UNICODE и ЮНИКОД не определены, RtlEthernetAddressToString определяется как RtlEthernetAddressToStringA, версия ANSI этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PSTR.

Тип данных DL_EUI48 определен в файле заголовка Mstcpip.h.

Заметка

Заголовок ip2string.h определяет RtlEthernetAddressToString как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7 [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows Server 2008 R2 [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	ip2string.h (include Mstcpip.h, Ip2string.h)
библиотеки	ntdll.lib
DLL	ntdll.dll

См. также

RtlEthernetStringToAddress

Поделиться через