fungsi if_indextoname
Fungsi if_indextoname mengonversi indeks lokal untuk antarmuka jaringan ke nama antarmuka ANSI.
Sintaksis
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parameter
InterfaceIndex [in]
Indeks lokal untuk antarmuka jaringan.InterfaceName [out]
Penunjuk ke buffer untuk menahan string ANSI yang dihentikan NULL. Jika if_indextoname berhasil, InterfaceName berisi nama antarmuka ANSI. Panjangnya, dalam byte, dari buffer yang dirujuk parameter ini harus sama dengan atau lebih besar dari IF_NAMESIZE. Untuk informasi selengkapnya tentang IF_NAMESIZE, lihat bagian Keterangan berikut ini.
Mengembalikan nilai
Jika fungsi ini berhasil, if_indextoname mengembalikan penunjuk ke string ANSI yang dihentikan NULL yang berisi nama antarmuka. Jika fungsi ini gagal, if_indextoname mengembalikan penunjuk NULL
Komentar
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.
Fungsi if_indextoname 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_indextoname dengan panggilan ke fungsiConvertInterfaceIndexToLuid untuk mengonversi indeks antarmuka ke gabungan NET_LUID, diikuti dengan panggilan ke fungsiConvertInterfaceLuidToNameA untuk mengonversi NET_LUID ke nama antarmuka ANSI.
Panjangnya, dalam byte, buffer yang dirujuk parameter InterfaceName harus sama atau lebih besar dari IF_NAMESIZE. Nilai IF_NAMESIZE didefinisikan dalam file header Netioapi.h sama dengan NDIS_IF_MAX_STRING_SIZE. Panjang maksimum nama antarmuka, NDIS_IF_MAX_STRING_SIZE, tanpa mengakhiri karakter NULL dideklarasikan dalam file header Ntddndis.h. NDIS_IF_MAX_STRING_SIZE didefinisikan sebagai konstanta IF_MAX_STRING_SIZE yang ditentukan dalam file header Ifdef.h.
Nota
File header Ntddndis.h dan Ifdef.h secara otomatis disertakan dalam file header Netioapi.h. Anda tidak boleh menggunakan Ntddndis.h dan ifdef.h file header secara langsung.
Jika fungsi if_indextoname gagal dan mengembalikan penunjuk NULL, 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 |