Fungsi ConvertInterfaceAliasToLuid

Artikel
06/15/2023

Fungsi ConvertInterfaceAliasToLuid mengonversi nama alias antarmuka untuk antarmuka jaringan 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 ConvertInterfaceAliasToLuid(
  _In_  const WCHAR     *InterfaceAlias,
  _Out_       PNET_LUID InterfaceLuid
);

Parameter

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

Menampilkan nilai

ConvertInterfaceAliasToLuid mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, parameter InterfaceLuid diatur ke NULL, dan ConvertInterfaceAliasToLuid mengembalikan kode kesalahan berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Salah satu parameter tidak valid. ConvertInterfaceAliasToLuid mengembalikan kesalahan ini jika InterfaceAlias atau InterfaceLuidNULL, atau jika InterfaceAlias tidak valid.

Keterangan

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

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