Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Funkcja ConvertInterfaceAliasToLuid konwertuje nazwę aliasu interfejsu 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 ConvertInterfaceAliasToLuid(
_In_ const WCHAR *InterfaceAlias,
_Out_ PNET_LUID InterfaceLuid
);
Parametry
InterfaceAlias [in]
Wskaźnik do ciągu Unicode zakończonego wartością NULL, który zawiera nazwę aliasu interfejsu sieciowego.InterfaceLuid [out]
Wskaźnik do unii NET_LUID dla interfejsu sieciowego.
Wartość zwracana
ConvertInterfaceAliasToLuid zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się. Jeśli funkcja zakończy się niepowodzeniem, parametr InterfaceLuid jest ustawiony na wartość null, a ConvertInterfaceAliasToLuid zwraca następujący kod błędu:
| Kod powrotny | Opis |
|---|---|
| STATUS_INVALID_PARAMETER | Jeden z parametrów był nieprawidłowy. ConvertInterfaceAliasToLuid zwraca ten błąd, jeśli InterfaceAlias lub InterfaceLuid jest nulllub jeśli InterfaceAlias jest nieprawidłowy. |
Uwagi
Funkcja ConvertInterfaceAliasToLuid 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 |