Fungsi ConvertInterfaceAliasToLuid (netioapi.h)

Artikel
02/29/2024

Fungsi ConvertInterfaceAliasToLuid mengonversi nama alias antarmuka untuk antarmuka jaringan ke pengidentifikasi unik lokal (LUID) untuk antarmuka.

Sintaks

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API ConvertInterfaceAliasToLuid(
  [in]  const WCHAR *InterfaceAlias,
  [out] PNET_LUID   InterfaceLuid
);

Parameter

[in] InterfaceAlias

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

[out] InterfaceLuid

Penunjuk ke NET_LUID untuk antarmuka ini.

Nilai kembali

Setelah berhasil, ConvertInterfaceAliasToLuid mengembalikan NO_ERROR. Nilai pengembalian bukan nol menunjukkan kegagalan dan NULL dikembalikan dalam parameter InterfaceLuid .

Kode kesalahan	Makna
ERROR_INVALID_PARAMETER	Salah satu parameter tidak valid. Kesalahan ini dikembalikan jika parameter InterfaceAlias atau InterfaceLuidadalah NULL atau jika parameter InterfaceAlias tidak valid.

Keterangan

Fungsi ConvertInterfaceAliasToLuid tersedia di Windows Vista dan yang lebih baru.

Fungsi ConvertInterfaceAliasToLuid adalah protokol independen dan bekerja dengan antarmuka jaringan untuk protokol IPv6 dan IPv4.

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