if_nametoindex (netioapi.h)

Artikel
08/25/2023

Fungsi if_nametoindex mengonversi nama antarmuka ANSI untuk antarmuka jaringan ke indeks lokal untuk antarmuka.

Sintaks

IPHLPAPI_DLL_LINKAGE NET_IFINDEX NETIOAPI_API_ if_nametoindex(
  [in] PCSTR InterfaceName
);

Parameter

[in] InterfaceName

Penunjuk ke string ANSI yang dihentikan NULL yang berisi nama antarmuka.

Mengembalikan nilai

Jika berhasil, if_nametoindex mengembalikan indeks antarmuka lokal. Jika gagal, nol dikembalikan.

Keterangan

Fungsi if_nametoindex tersedia di Windows Vista dan yang lebih baru.

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. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc2553.txt.

Fungsi if_nametoindex diimplementasikan untuk portabilitas aplikasi dengan lingkungan Unix, tetapi fungsi ConvertInterface lebih disukai. Fungsi if_nametoindex dapat diganti dengan panggilan ke fungsi ConvertInterfaceNameToLuidA untuk mengonversi nama antarmuka ANSI menjadi NET_LUID diikuti dengan panggilan ke ConvertInterfaceLuidToIndex untuk mengonversi NET_LUID ke indeks antarmuka lokal.

Jika fungsi if_nametoindex gagal dan mengembalikan nol, tidak mungkin untuk menentukan kode kesalahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	netioapi.h (termasuk Iphlpapi.h)
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll