ConvertInterfaceLuidToNameW, funkcja
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 |