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 ConvertInterfaceLuidToNameW konwertuje lokalnie unikatowy identyfikator (LUID) dla interfejsu sieciowego na nazwę interfejsu Unicode.
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 ConvertInterfaceLuidToNameW(
_In_ const NET_LUID *InterfaceLuid,
_Out_ PWSTR InterfaceName,
_In_ SIZE_T Length
);
Parametry
InterfaceLuid [in]
Wskaźnik do unii NET_LUID dla interfejsu sieciowego.InterfaceName [out]
Wskaźnik do buforu do przechowywania ciągu Unicode zakończonego wartością NULL. Jeśli funkcja ConvertInterfaceLuidToNameW zostanie zwrócona pomyślnie, InterfaceName zawiera nazwę interfejsu Unicode.długość [in]
Długość buforu według liczby znaków wskazuje parametr InterfaceName. Ta wartość musi być wystarczająco duża, aby przechowywać nazwę interfejsu i kończący znak NULL. Maksymalna dozwolona długość wynosi NDIS_IF_MAX_STRING_SIZE + 1. Aby uzyskać więcej informacji na temat NDIS_IF_MAX_STRING_SIZE, zobacz następującą sekcję Uwagi.
Wartość zwracana
ConvertInterfaceLuidToNameW zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się. Jeśli funkcja nie powiedzie się, ConvertInterfaceLuidToNameW zwraca jeden z następujących kodów błędów:
| Kod powrotny | Opis |
|---|---|
| STATUS_INVALID_PARAMETER | Jeden z parametrów jest nieprawidłowy. ConvertInterfaceLuidToNameW zwraca ten błąd, jeśli InterfaceLuid lub InterfaceName jest nulllub jeśli InterfaceLuid jest nieprawidłowy. |
| STATUS_NOT_ENOUGH_MEMORY | ConvertInterfaceLuidToNameW zwraca ten błąd, jeśli bufor InterfaceName nie był tak duży, jak określono w parametrze długości i dlatego bufor nie może przechowywać nazwy interfejsu. |
Uwagi
Funkcja ConvertInterfaceLuidToNameW jest niezależna od protokołu i współpracuje z interfejsami sieciowymi zarówno dla protokołów IPv6, jak i IPv4.
Maksymalna długość nazwy interfejsu sieciowego, NDIS_IF_MAX_STRING_SIZE bez znaku null zakończenia, jest definiowana w pliku nagłówka Ntddndis.h. NDIS_IF_MAX_STRING_SIZE jest definiowana jako stała IF_MAX_STRING_SIZE, która jest zdefiniowana w pliku nagłówka Ifdef.h.
Nuta
Pliki nagłówków Ntddndis.h i Ifdef.h są automatycznie dołączane do pliku nagłówka Netioapi.h. Nigdy nie należy używać plików nagłówków Ntddndis.h i Ifdef.h bezpośrednio.
Użyj ConvertInterfaceLuidToNameA, aby przekonwertować identyfikator LUID interfejsu sieciowego na nazwę interfejsu ANSI.
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 |