Fungsi RtlEthernetStringToAddressA (ip2string.h)
Fungsi RtlEthernetStringToAddress mengonversi representasi string alamat MAC Ethernet ke format biner alamat Ethernet.
Sintaks
NTSYSAPI NTSTATUS RtlEthernetStringToAddressA(
[in] PCSTR S,
[out] PCSTR *Terminator,
[out] DL_EUI48 *Addr
);
Parameter
[in] S
Penunjuk ke buffer yang berisi representasi string yang dihentikan NULL dari alamat MAC Ethernet.
[out] Terminator
Parameter yang menerima penunjuk ke karakter yang mengakhiri string yang dikonversi. Ini dapat digunakan oleh pemanggil untuk mengekstrak informasi lebih lanjut dari string.
[out] Addr
Penunjuk tempat representasi biner alamat MAC Ethernet akan disimpan.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah STATUS_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah salah satu kode kesalahan berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika string yang ditunjukkan oleh parameter S tidak berisi representasi string yang tepat dari alamat MAC Ethernet.
Kode kesalahan ini didefinisikan dalam file header Ntstatus.h . |
|
Gunakan FormatMessage untuk mendapatkan string pesan untuk kesalahan yang dikembalikan. |
Keterangan
Fungsi RtlEthernetStringToAddress digunakan untuk mengonversi representasi string alamat lapisan tautan data Ethernet EUI-48 (juga umumnya dikenal sebagai alamat MAC) ke format biner alamat Ethernet. String mewakili alamat Ethernet numerik yang dinyatakan dalam notasi "-'' standar non-DIX. Nilai yang dikembalikan adalah angka yang cocok untuk digunakan sebagai alamat Ethernet. Semua alamat Ethernet dikembalikan dalam urutan jaringan (byte diurutkan dari kiri ke kanan).
String yang ditunjukkan oleh parameter S harus 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).
Setelah berhasil, parameter Terminator menunjuk ke karakter yang mengakhiri string yang dikonversi. Ini memungkinkan aplikasi untuk meneruskan string yang berisi alamat Ethernet ditambah informasi tambahan ke fungsi RtlEthernetStringToAddress dan kemudian mengurai informasi yang tersisa.
RtlEthernetStringToAddress 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, RtlEthernetStringToAddress didefinisikan ke RtlEthernetStringToAddressW, versi Unicode dari fungsi ini. Parameter S dan Terminator didefinisikan ke jenis data PCWSTR .
Ketika UNICODE dan _UNICODE tidak ditentukan, RtlEthernetStringToAddress didefinisikan ke RtlEthernetStringToAddressA, versi ANSI dari fungsi ini. Parameter S dan Terminator didefinisikan ke jenis data PCSTR .
Jenis data DL_EUI48 ditentukan dalam file header Mstcpip.h .
Catatan
Header ip2string.h mendefinisikan RtlEthernetStringToAddress 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk