ConvertInterfaceLuidToIndex, funkcja

Funkcja ConvertInterfaceLuidToIndex konwertuje lokalnie unikatowy identyfikator (LUID) dla interfejsu sieciowego na indeks lokalny 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 ConvertInterfaceLuidToIndex(
  _In_  const NET_LUID     *InterfaceLuid,
  _Out_       PNET_IFINDEX InterfaceIndex
);

Parametry

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

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

Wartość zwracana

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

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

Uwagi

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

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID