Функция RtlEthernetAddressToStringA (ip2string.h)
Функция RtlEthernetAddressToString преобразует двоичный адрес Ethernet в строковое представление MAC-адреса Ethernet.
Синтаксис
NTSYSAPI PSTR RtlEthernetAddressToStringA(
[in] const DL_EUI48 *Addr,
[out] PSTR S
);
Параметры
[in] Addr
Адрес Ethernet в двоичном формате. Адрес Ethernet находится в сетевом порядке (байты упорядочены слева направо).
[out] S
Указатель на буфер, в котором хранится строковое представление адреса Ethernet, завершающееся значением NULL. Этот буфер должен быть достаточно большим, чтобы вместить не менее 18 символов.
Возвращаемое значение
Указатель на символ NULL, вставленный в конце строкового представления MAC-адреса Ethernet. Его может использовать вызывающий объект, чтобы легко добавлять дополнительные сведения в строку.
Комментарии
Функция RtlEthernetAddressToString используется для преобразования двоичного ethernet-адреса в строковое представление адреса Ethernet в формате адресов канала данных Ethernet EUI-48 (также известном как MAC-адрес). Строка представляет числовой адрес Ethernet, выраженный в стандартной нотации "-", отличной от DIX.
Строка, возвращаемая в параметре S , представлена в виде строки MAC-адреса Ethernet в стандартной нотации "-", отличной от DIX. Базовое строковое представление MAC-адреса Ethernet состоит из 6 пар шестнадцатеричных чисел, разделенных дефисами (например, F4-CE-46-2D-90-8C).
RtlEthernetAddressToString — это удобная функция, которая не требует загрузки библиотеки DLL windows sockets для доступа к функции, предоставленной в Windows Sockets для выполнения преобразования строк в адрес Ethernet.
Если определен юникод или _UNICODE, RtlEthernetAddressToString определяется как RtlEthernetAddressToStringW, версия Юникода этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PWSTR .
Если и UNICODE, и _UNICODE не определены, RtlEthernetAddressToString определяется как RtlEthernetAddressToStringA, версия ANSI этой функции. Строковый параметр S и возвращаемое значение функции определяются для типа данных PSTR .
Тип данных DL_EUI48 определяется в файле заголовка Mstcpip.h .
Примечание
Заголовок ip2string.h определяет RtlEthernetAddressToString в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | ip2string.h (включая Mstcpip.h, Ip2string.h) |
| Библиотека | ntdll.lib |
| DLL | ntdll.dll |