Fungsi ConvertInterfaceNameToLuidW (netioapi.h)

Artikel
03/13/2024

Fungsi ConvertInterfaceNameToLuidW mengonversi nama antarmuka jaringan Unicode menjadi pengidentifikasi unik lokal (LUID) untuk antarmuka.

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceNameToLuidW(
  [in]  const WCHAR *InterfaceName,
  [out] NET_LUID    *InterfaceLuid
);

Parameter

[in] InterfaceName

Penunjuk ke string Unicode yang dihentikan NULL yang berisi nama antarmuka jaringan.

[out] InterfaceLuid

Penunjuk ke NET_LUID untuk antarmuka ini.

Nilai kembali

Setelah berhasil, ConvertInterfaceNameToLuidW mengembalikan NETIO_ERROR_SUCCESS. Nilai pengembalian bukan nol menunjukkan kegagalan.

Kode kesalahan	Makna
ERROR_INVALID_NAME	Nama antarmuka tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceName berisi nama yang tidak valid atau panjang parameter InterfaceName melebihi panjang string maksimum yang diizinkan untuk parameter ini.
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceLuid adalah NULL.

Keterangan

Fungsi ConvertInterfaceNameToLuidW tersedia di Windows Vista dan yang lebih baru.

Fungsi ConvertInterfaceNameToLuidW adalah protokol independen dan berfungsi dengan antarmuka jaringan untuk protokol IPv6 dan IPv4. ConvertInterfaceNameToLuidW mengonversi nama antarmuka Unicode menjadi LUID.

ConvertInterfaceNameToLuidA mengonversi nama antarmuka ANSI menjadi LUID.

Panjang maksimum nama antarmuka, NDIS_IF_MAX_STRING_SIZE, tanpa MENGAKHIRI NULL dinyatakan dalam file header Ntddndis.h . NDIS_IF_MAX_STRING_SIZE didefinisikan sebagai konstanta IF_MAX_STRING_SIZE yang ditentukan dalam file header Ifdef.h. File header Ntddndis.h dan Ifdef.h secara otomatis disertakan dalam file header Netioapi.h yang secara otomatis disertakan oleh file header Iphlpapi.h . File header Ntddndis.h, Ifdef.h, dan Netioapi.h tidak boleh digunakan secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	netioapi.h (termasuk Iphlpapi.h)
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll