fungsi if_nametoindex
Fungsi if_nametoindex mengonversi nama antarmuka ANSI untuk antarmuka jaringan ke indeks lokal untuk antarmuka.
Sintaksis
NET_IFINDEX NETIOAPI_API_ if_nametoindex(
_In_ PCSTR InterfaceName
);
Parameter
-
InterfaceName [in]
Penunjuk ke string ANSI yang dihentikan NULL yang berisi nama antarmuka.
Mengembalikan nilai
Jika fungsi berhasil, if_nametoindex mengembalikan indeks antarmuka lokal. Jika fungsi gagal, if_nametoindex mengembalikan nol.
Komentar
Fungsi if_nametoindex memetakan nama antarmuka ke dalam indeks yang sesuai. Fungsi ini dirancang sebagai bagian dari ekstensi soket dasar untuk IPv6 seperti yang dijelaskan oleh IETF di RFC 2553.
Fungsi if_nametoindex diimplementasikan untuk portabilitas driver dengan lingkungan Unix, tetapi fungsi ConvertInterfaceXxx adalah metode yang lebih disukai untuk mengonversi pengidentifikasi antarmuka jaringan. Anda dapat mengganti fungsi if_nametoindex dengan panggilan ke fungsiConvertInterfaceNameToLuidA untuk mengonversi nama antarmuka ANSI menjadi gabungan NET_LUID, diikuti dengan panggilan ke fungsi ConvertInterfaceLuidToIndex untuk mengonversi NET_LUID ke indeks antarmuka lokal.
Jika fungsi if_nametoindex gagal dan mengembalikan nol, Anda tidak dapat menentukan kode kesalahan.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi sistem operasi Windows yang lebih baru. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Perpustakaan |
Netio.lib |
IRQL |
PASSIVE_LEVEL |