Fungsi ConvertInterfaceNameToLuidW

Artikel
03/08/2023

Fungsi ConvertInterfaceNameToLuidW mengonversi nama antarmuka jaringan Unicode menjadi 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 ConvertInterfaceNameToLuidW(
  _In_  const WCHAR    *InterfaceName,
  _Out_       NET_LUID *InterfaceLuid
);

Parameter

InterfaceName [in]
Penunjuk ke string Unicode yang dihentikan NULL yang berisi nama antarmuka jaringan.
InterfaceLuid [out]
Penunjuk ke serikat NET_LUID untuk antarmuka ini.

Mengembalikan nilai

ConvertInterfaceNameToLuidW mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, ConvertInterfaceNameToLuidW mengembalikan salah satu kode kesalahan berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_NAME	Nama antarmuka tidak valid. ConvertInterfaceNameToLuidW mengembalikan kesalahan ini jika parameter InterfaceName berisi nama yang tidak valid atau panjang parameter InterfaceName melebihi panjang string maksimum yang diizinkan untuk parameter ini.
STATUS_INVALID_PARAMETER	Salah satu parameter tidak valid. ConvertInterfaceNameToLuidW mengembalikan kesalahan ini jika parameter InterfaceLuid adalah NULL.

Keterangan

Fungsi ConvertInterfaceNameToLuidW independen protokol dan berfungsi dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.

Panjang maksimum nama 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 ConvertInterfaceNameToLuidA untuk mengonversi nama antarmuka ANSI 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