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