Fungsi ConvertInterfaceNameToLuidA
Fungsi ConvertInterfaceNameToLuidA mengonversi nama antarmuka jaringan ANSI ke pengidentifikasi unik lokal (LUID) untuk antarmuka.
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 ConvertInterfaceNameToLuidA(
_In_ const CHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parameter
InterfaceName [in]
Penunjuk ke string ANSI yang dihentikan NULL yang berisi nama antarmuka jaringan.InterfaceLuid [out]
Penunjuk ke serikat NET_LUID untuk antarmuka ini.
Mengembalikan nilai
ConvertInterfaceNameToLuidA mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, ConvertInterfaceNameToLuidA mengembalikan salah satu kode kesalahan berikut:
Menampilkan kode | Deskripsi |
---|---|
ERROR_BUFFER_OVERFLOW | Panjang nama antarmuka ANSI tidak valid. ConvertInterfaceNameToLuidA mengembalikan kesalahan ini jika parameter InterfaceName melebihi panjang string maksimum yang diizinkan untuk parameter ini. |
STATUS_INVALID_NAME | Nama antarmuka tidak valid. ConvertInterfaceNameToLuidA mengembalikan kesalahan ini jika parameter InterfaceName berisi nama antarmuka yang tidak valid. |
STATUS_INVALID_PARAMETER | Salah satu parameter tidak valid. ConvertInterfaceNameToLuidA mengembalikan kesalahan ini jika parameter InterfaceLuid adalah NULL. |
Keterangan
Fungsi ConvertInterfaceNameToLuidA independen protokol dan berfungsi dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.
Panjang maksimum nama antarmuka jaringan, NDIS_IF_MAX_STRING_SIZE, tanpa 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 ConvertInterfaceNameToLuidW untuk mengonversi nama antarmuka Unicode menjadi LUID.
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 |