if_indextoname (netioapi.h)

Artikel
03/05/2024

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

Sintaks

IPHLPAPI_DLL_LINKAGE PCHAR NETIOAPI_API_ if_indextoname(
  [in]  NET_IFINDEX InterfaceIndex,
  [out] PCHAR       InterfaceName
);

Parameter

[in] InterfaceIndex

Indeks lokal untuk antarmuka jaringan.

[out] InterfaceName

Penunjuk ke buffer untuk menahan string ANSI yang dihentikan NULL yang berisi nama antarmuka saat fungsi berhasil dikembalikan. Panjangnya, dalam byte, dari buffer yang diacu oleh parameter ini harus sama dengan atau lebih besar dari IF_NAMESIZE.

Nilai kembali

Setelah berhasil, if_indextoname mengembalikan penunjuk ke string ANSI yang dihentikan NULL yang berisi nama antarmuka. Jika gagal, penunjuk NULL dikembalikan.

Keterangan

Fungsi if_indextoname tersedia di Windows Vista dan yang lebih baru.

Fungsi if_indextoname memetakan indeks antarmuka ke dalam nama 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_indextoname diimplementasikan untuk portabilitas aplikasi dengan lingkungan Unix, tetapi fungsi ConvertInterface lebih disukai. Fungsi if_indextoname dapat diganti dengan panggilan ke fungsi ConvertInterfaceIndexToLuid untuk mengonversi indeks antarmuka ke NET_LUID diikuti dengan panggilan ke ConvertInterfaceLuidToNameA untuk mengonversi NET_LUID ke nama antarmuka ANSI.

Jika if_indextoname gagal dan mengembalikan penunjuk NULL , tidak dimungkinkan untuk menentukan kode kesalahan.

Panjangnya, dalam byte, dari buffer yang diacu oleh parameter InterfaceName harus sama atau lebih besar dari IF_NAMESIZE, nilai yang dideklarasikan dalam file header Netioapi.h sama dengan NDIS_IF_MAX_STRING_SIZE. Panjang maksimum nama antarmuka, NDIS_IF_MAX_STRING_SIZE, tanpa PENGHENTIAN NULL dinyatakan dalam file header Ntddndis.h . NDIS_IF_MAX_STRING_SIZE didefinisikan sebagai konstanta IF_MAX_STRING_SIZE yang ditentukan dalam file header Ifdef.h. File header Ntddndis.h dan Ifdef.h secara otomatis disertakan dalam file header Netioapi.h yang secara otomatis disertakan oleh file header Iphlpapi.h . File header Ntddndis.h, Ifdef.h, dan Netioapi.h tidak boleh digunakan secara langsung.

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