Fungsi ConvertInterfaceLuidToIndex

Artikel
06/15/2023

Fungsi ConvertInterfaceLuidToIndex mengonversi pengidentifikasi unik lokal (LUID) untuk antarmuka jaringan ke indeks lokal 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 ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

Parameter

InterfaceLuid [in]
Penunjuk ke serikat NET_LUID untuk antarmuka jaringan.
InterfaceIndex [out]
Nilai indeks lokal untuk antarmuka jaringan.

Menampilkan nilai

ConvertInterfaceLuidToIndex mengembalikan STATUS_SUCCESS jika fungsi berhasil. Jika fungsi gagal, parameter InterfaceIndex diatur ke NET_IFINDEX_UNSPECIFIED, dan ConvertInterfaceLuidToIndex mengembalikan kode kesalahan berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_PARAMETER	Salah satu parameter tidak valid. ConvertInterfaceLuidToIndex mengembalikan kesalahan ini jika InterfaceLuid atau InterfaceIndexNULL, atau jika InterfaceLuid tidak valid.

Keterangan

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