Udostępnij przez


ConvertInterfaceLuidToGuid, funkcja

Funkcja ConvertInterfaceLuidToGuid konwertuje lokalnie unikatowy identyfikator (LUID) dla interfejsu sieciowego na globalnie unikatowy identyfikator (GUID) 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 ConvertInterfaceLuidToGuid(
  _In_  const NET_LUID *InterfaceLuid,
  _Out_       GUID     *InterfaceGuid
);

Parametry

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

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

Wartość zwracana

ConvertInterfaceLuidToGuid zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się. Jeśli funkcja nie powiedzie się, parametr InterfaceGuid jest ustawiony na wartość null, a ConvertInterfaceLuidToGuid zwraca następujący kod błędu:

Kod powrotny Opis
STATUS_INVALID_PARAMETER

Jeden z parametrów jest nieprawidłowy. ConvertInterfaceLuidToGuid zwraca ten błąd, jeśli InterfaceLuid lub InterfaceGuid jest nulllub jeśli InterfaceLuid jest nieprawidłowy.

Uwagi

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

ConvertInterfaceLuidToIndex

ConvertInterfaceLuidToNameA

ConvertInterfaceLuidToNameW

ConvertInterfaceNameToLuidA

ConvertInterfaceNameToLuidW

NET_LUID