ConvertInterfaceGuidToLuid, funkcja

Funkcja ConvertInterfaceGuidToLuid konwertuje globalnie unikatowy identyfikator (GUID) 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 ConvertInterfaceGuidToLuid(
  _In_  const GUID      *InterfaceGuid,
  _Out_       PNET_LUID InterfaceLuid
);

Parametry

• InterfaceGuid [in]
  Wskaźnik do identyfikatora GUID dla interfejsu sieciowego.

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

Wartość zwracana

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

Kod powrotny	Opis
STATUS_INVALID_PARAMETER	Jeden z parametrów był nieprawidłowy. ConvertInterfaceGuidToLuid zwraca ten błąd, jeśli InterfaceAlias lub InterfaceLuid jest nulllub jeśli InterfaceGuid jest nieprawidłowa.

Uwagi

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

ConvertInterfaceIndexToLuid

ConvertInterfaceLuidToAlias

ConvertInterfaceLuidToGuid

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID