if_indextoname, funkcja
Funkcja if_indextoname konwertuje indeks lokalny interfejsu sieciowego na nazwę interfejsu ANSI.
Składnia
PCHAR NETIOAPI_API_ if_indextoname(
_In_ NET_IFINDEX InterfaceIndex,
_Out_ PCHAR InterfaceName
);
Parametry
InterfaceIndex [in]
Indeks lokalny interfejsu sieciowego.InterfaceName [out]
Wskaźnik do buforu do przechowywania ciągu ANSI zakończonego wartością NULL. Jeśli if_indextoname powiedzie się, InterfaceName zawiera nazwę interfejsu ANSI. Długość w bajtach buforu, do którego wskazuje ten parametr, musi być równa lub większa niż IF_NAMESIZE. Aby uzyskać więcej informacji na temat IF_NAMESIZE, zobacz następującą sekcję Uwagi.
Wartość zwracana
Jeśli ta funkcja powiedzie się, if_indextoname zwraca wskaźnik do ciągu ANSI zakończonego wartością NULL, który zawiera nazwę interfejsu. Jeśli ta funkcja nie powiedzie się, if_indextoname zwraca wskaźnik o wartości null
Uwagi
Funkcja if_indextoname mapuje indeks interfejsu na odpowiednią nazwę. Ta funkcja została zaprojektowana jako część podstawowych rozszerzeń gniazd dla protokołu IPv6, zgodnie z opisem w pliku IETF w RFC 2553.
Funkcja if_indextoname jest implementowana w celu przenoszenia sterowników ze środowiskami systemu Unix, ale ConvertInterfaceXxx funkcje są preferowaną metodą konwertowania identyfikatorów interfejsu sieciowego. Funkcję if_indextoname można zastąpić wywołaniem funkcji ConvertInterfaceIndexToLuid w celu przekonwertowania indeksu interfejsu na unię NET_LUID, a następnie wywołanie funkcji ConvertInterfaceLuidToNameA w celu przekonwertowania NET_LUID na nazwę interfejsu ANSI.
Długość buforu InterfaceName musi być równa lub większa niż IF_NAMESIZE. Wartość IF_NAMESIZE jest zdefiniowana w pliku nagłówkowym Netioapi.h równym NDIS_IF_MAX_STRING_SIZE. Maksymalna długość nazwy interfejsu, NDIS_IF_MAX_STRING_SIZE, bez znaku null zakończenia jest zadeklarowana w pliku nagłówka Ntddndis.h. NDIS_IF_MAX_STRING_SIZE jest zdefiniowana jako stała IF_MAX_STRING_SIZE 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.
Jeśli funkcja if_indextoname zakończy się niepowodzeniem i zwróci wskaźnik o wartości null, nie można określić kodu błędu.
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 |