Fungsi ConvertInterfaceNameToLuidA

Artikel
03/08/2023

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