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 ConvertInterfaceNameToLuidW konwertuje nazwę interfejsu sieciowego Unicode 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 ConvertInterfaceNameToLuidW(
_In_ const WCHAR *InterfaceName,
_Out_ NET_LUID *InterfaceLuid
);
Parametry
InterfaceName [in]
Wskaźnik do ciągu Unicode zakończonego wartością NULL, który zawiera nazwę interfejsu sieciowego.InterfaceLuid [out]
Wskaźnik do unii NET_LUID dla tego interfejsu.
Wartość zwracana
ConvertInterfaceNameToLuidW zwraca STATUS_SUCCESS, jeśli funkcja powiedzie się. Jeśli funkcja nie powiedzie się, ConvertInterfaceNameToLuidW zwraca jeden z następujących kodów błędów:
| Kod powrotny | Opis |
|---|---|
| STATUS_INVALID_NAME | Nazwa interfejsu jest nieprawidłowa. ConvertInterfaceNameToLuidW zwraca ten błąd, jeśli parametr InterfaceName zawiera nieprawidłową nazwę lub długość parametru InterfaceName przekracza maksymalną dozwoloną długość ciągu dla tego parametru. |
| STATUS_INVALID_PARAMETER | Jeden z parametrów jest nieprawidłowy. ConvertInterfaceNameToLuidW zwraca ten błąd, jeśli parametr interfejsu jest null. |
Uwagi
Funkcja ConvertInterfaceNameToLuidW jest niezależna od protokołu i współpracuje z interfejsami sieciowymi dla protokołów IPv6 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 funkcji ConvertInterfaceNameToLuidA, aby przekonwertować nazwę interfejsu ANSI na identyfikator LUID.
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 |