Fungsi ConvertInterfaceGuidToLuid

Artikel
06/15/2023

Fungsi ConvertInterfaceGuidToLuid mengonversi pengidentifikasi unik global (GUID) 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 ConvertInterfaceGuidToLuid(
  _In_  const GUID      *InterfaceGuid,
  _Out_       PNET_LUID InterfaceLuid
);

Parameter

InterfaceGuid [in]
Penunjuk ke GUID untuk antarmuka jaringan.
InterfaceLuid [out]
Penunjuk ke serikat NET_LUID untuk antarmuka jaringan.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Salah satu parameter tidak valid. ConvertInterfaceGuidToLuid mengembalikan kesalahan ini jika InterfaceAlias atau InterfaceLuidadalah NULL, atau jika InterfaceGuid tidak valid.

Keterangan

Fungsi ConvertInterfaceGuidToLuid 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