Fungsi RtlEthernetAddressToStringA (ip2string.h)

Fungsi RtlEthernetAddressToString mengonversi alamat Ethernet biner menjadi representasi string alamat MAC Ethernet.

Sintaks

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

Parameter

[in] Addr

Alamat Ethernet dalam format biner. Alamat Ethernet berada dalam urutan jaringan (byte diurutkan dari kiri ke kanan).

[out] S

Penunjuk ke buffer untuk menyimpan representasi string yang dihentikan NULL dari alamat Ethernet. Buffer ini harus cukup besar untuk menampung setidaknya 18 karakter.

Nilai kembali

Penunjuk ke karakter NULL yang dimasukkan di akhir representasi string alamat MAC Ethernet. Ini dapat digunakan oleh pemanggil untuk dengan mudah menambahkan informasi lebih lanjut ke string.

Keterangan

Fungsi RtlEthernetAddressToString digunakan untuk mengonversi alamat Ethernet biner ke representasi string alamat Ethernet dalam format alamat lapisan tautan data Ethernet EUI-48 (juga umumnya dikenal sebagai alamat MAC). String mewakili alamat Ethernet numerik yang dinyatakan dalam notasi "-'' standar non-DIX.

String yang dikembalikan dalam parameter S diwakili dalam formulir untuk string alamat MAC Ethernet dalam notasi "-" standar non-DIX. Representasi string dasar alamat MAC Ethernet terdiri dari 6 pasang angka heksadesimal yang dipisahkan oleh tanda hubung (F4-CE-46-2D-90-8C, misalnya).

RtlEthernetAddressToString adalah fungsi kenyamanan yang tidak mengharuskan Windows Sockets DLL dimuat untuk mengakses fungsi yang disediakan di Soket Windows untuk melakukan string ke konversi alamat Ethernet.

Ketika UNICODE atau _UNICODE ditentukan, RtlEthernetAddressToString didefinisikan ke RtlEthernetAddressToStringW, versi Unicode dari fungsi ini. Parameter string S dan nilai pengembalian fungsi ditentukan ke jenis data PWSTR .

Ketika UNICODE dan _UNICODE tidak ditentukan, RtlEthernetAddressToString didefinisikan ke RtlEthernetAddressToStringA, versi ANSI dari fungsi ini. Parameter string S dan nilai pengembalian fungsi ditentukan ke jenis data PSTR .

Jenis data DL_EUI48 ditentukan dalam file header Mstcpip.h .

Catatan

Header ip2string.h mendefinisikan RtlEthernetAddressToString sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	ip2string.h (termasuk Mstcpip.h, Ip2string.h)
Pustaka	ntdll.lib
DLL	ntdll.dll

Lihat juga

RtlEthernetStringToAddress