Fungsi ConvertInterfaceLuidToNameA
Fungsi ConvertInterfaceLuidToNameA mengonversi pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan ke nama antarmuka ANSI.
Catatan
Keluarga ConvertInterfaceXxx API menghitung pengidentifikasi di semua antarmuka yang terikat ke TCP/IP, yang mungkin mencakup miniport virtual, filter ringan, adaptor terowongan, dan antarmuka fisik.
Sintaks
NETIOAPI_API ConvertInterfaceLuidToNameA(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PSTR InterfaceName,
_In_ SIZE_T Length
);
Parameter
InterfaceLuid [in]
Penunjuk ke serikat NET_LUID untuk antarmuka jaringan.InterfaceName [out]
Penunjuk ke buffer untuk menahan string ANSI yang dihentikan NULL. Jika ConvertInterfaceLuidToNameA berhasil ditampilkan, InterfaceName berisi nama antarmuka ANSI.Panjang [in]
Panjang, dalam byte, dari buffer yang dirujuk parameter InterfaceName . Nilai ini harus cukup besar untuk menahan nama antarmuka dan karakter NULL yang mengakhiri. Panjang maksimum yang diizinkan adalah NDIS_IF_MAX_STRING_SIZE + 1. Untuk informasi selengkapnya tentang NDIS_IF_MAX_STRING_SIZE, lihat bagian Keterangan berikut ini.
Nilai kembali
ConvertInterfaceLuidToNameA mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, ConvertInterfaceLuidToNameA mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
STATUS_INVALID_PARAMETER | Salah satu parameter tidak valid. ConvertInterfaceLuidToNameA mengembalikan kesalahan ini jika InterfaceLuid atau InterfaceNameadalah NULL, atau jika InterfaceLuid tidak valid. |
STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameA mengembalikan kesalahan ini jika buffer InterfaceName tidak sebesar yang ditentukan dalam parameter Panjang dan, oleh karena itu, buffer tidak dapat menahan nama antarmuka. |
Keterangan
Fungsi ConvertInterfaceLuidToNameA independen protokol dan berfungsi dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.
Panjang maksimum nama untuk antarmuka jaringan, NDIS_IF_MAX_STRING_SIZE, tanpa karakter NULL yang mengakhiri, didefinisikan dalam file header Ntddndis.h. NDIS_IF_MAX_STRING_SIZE didefinisikan sebagai konstanta IF_MAX_STRING_SIZE, yang didefinisikan dalam file header Ifdef.h.
Catatan
File header Ntddndis.h dan Ifdef.h secara otomatis disertakan dalam file header Netioapi.h . Anda tidak boleh menggunakan file header Ntddndis.h dan Ifdef.h secara langsung.
Gunakan fungsi ConvertInterfaceLuidToNameW untuk mengonversi LUID antarmuka jaringan menjadi nama antarmuka Unicode.
Persyaratan
Platform target |
Universal |
Versi |
Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
Header |
Netioapi.h (termasuk Netioapi.h) |
Pustaka |
Netio.lib |
IRQL |
PASSIVE_LEVEL |
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