ConvertInterfaceIndexToLuid, funkcja

Funkcja ConvertInterfaceIndexToLuid konwertuje indeks lokalny dla interfejsu sieciowego na lokalnie unikatowy identyfikator (LUID) dla interfejsu.

Nuta

Rodzina interfejsów API ConvertInterfaceXxx wylicza identyfikatory wszystkich interfejsów powiązanych z protokołem TCP/IP, które mogą obejmować wirtualne miniporty, lekkie filtry, karty tunelowe i interfejsy fizyczne.

Składnia

NETIOAPI_API ConvertInterfaceIndexToLuid(
  _In_  NET_IFINDEX InterfaceIndex,
  _Out_ PNET_LUID   InterfaceLuid
);

Parametry

• InterfaceIndex [in]
  Wartość indeksu lokalnego dla interfejsu sieciowego.

• InterfaceLuid [out]
  Wskaźnik do unii NET_LUID dla interfejsu sieciowego.

Wartość zwracana

ConvertInterfaceIndexToLuid zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się. Jeśli funkcja zakończy się niepowodzeniem, parametr InterfaceLuid jest ustawiony na NULL, a ConvertInterfaceIndexToLuid zwraca następujący kod błędu:

Kod powrotny	Opis
STATUS_INVALID_PARAMETER	Jeden z parametrów był nieprawidłowy. ConvertInterfaceIndexToLuid zwraca ten błąd, jeśli parametr InterfaceLuid jest nulllub jeśli parametr InterfaceIndex jest nieprawidłowy.

Uwagi

Funkcja ConvertInterfaceIndexToLuid jest niezależna od protokołu i współpracuje z interfejsami sieciowymi dla protokołów IPv6 i IPv4.

Wymagania

Platforma docelowa	universal
Wersja	Dostępne w systemie Windows Vista i nowszych wersjach systemów operacyjnych Windows.
Nagłówek	Netioapi.h (include Netioapi.h)
Biblioteka	Netio.lib
IRQL	PASSIVE_LEVEL

Zobacz też

ConvertInterfaceAliasToLuid

ConvertInterfaceGuidToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID