Udostępnij za pośrednictwem

Omówienie funkcji IP Helper

  • Artykuł

Pomocnik protokołu internetowego (Pomocnik IP) umożliwia sterownikom pobieranie informacji o konfiguracji sieci komputera lokalnego i modyfikowanie tej konfiguracji. Pomocnik adresów IP udostępnia również mechanizmy powiadomień, aby upewnić się, że sterownik jest powiadamiany o zmianie niektórych aspektów konfiguracji sieci komputera lokalnego. Pomocnik IP jest dostępny w systemie Windows Vista i nowszych wersjach systemów operacyjnych Microsoft Windows.

Wiele funkcji pomocnika IP przekazuje parametry struktury reprezentujące typy danych skojarzone z technologią MIB (Management Information Base). Funkcje Pomocnika IP używają tych struktur MIB do reprezentowania różnych informacji o sieci.

Dokumentacja pomocnika IP używa terminów adapter i interfejs często. Adapter to przestarzały termin będący skróconą formą adaptera sieciowego, który pierwotnie odnosił się do jakiejś formy sprzętu sieciowego. Adapter to abstrakcja na poziomie łącza danych.

Interfejs jest opisany w dokumentach IETF RFC jako abstrakcyjna koncepcja reprezentująca przyłączenie węzła do łącza. Interfejs to abstrakcja na poziomie adresu IP.

Sterownik może używać następujących funkcji trybu jądra, struktur MIB oraz wyliczeń MIB i warstwy sieciowej (NL), aby pobrać i zmodyfikować ustawienia konfiguracji dla transportu protokołu TCP/IP (Transmission Control Protocol/Internet Protocol) na komputerze lokalnym.

Notatka

Podczas opracowywania kodu sterownika postępuj zgodnie z instrukcjami dla , uwzględniając pliki nagłówkowe.

Funkcje konwersji interfejsu

Funkcja Opis
ConvertInterfaceAliasToLuid Konwertuje lokalnie unikatowy identyfikator (LUID) dla interfejsu sieciowego na nazwę interfejsu Unicode.
ConvertInterfaceGuidToLuid Konwertuje globalnie unikatowy identyfikator (GUID) dla interfejsu sieciowego na identyfikator LUID dla interfejsu.
ConvertInterfaceIndexToLuid Konwertuje indeks lokalny dla interfejsu sieciowego na identyfikator LUID dla interfejsu.
ConvertInterfaceLuidToAlias Konwertuje identyfikator LUID dla interfejsu sieciowego na alias interfejsu.
ConvertInterfaceLuidToGuid Konwertuje identyfikator LUID dla interfejsu sieciowego na identyfikator GUID dla interfejsu.
ConvertInterfaceLuidToIndex Konwertuje identyfikator LUID dla interfejsu sieciowego na indeks lokalny dla interfejsu.
ConvertInterfaceLuidToNameA Konwertuje identyfikator LUID dla interfejsu sieciowego na nazwę interfejsu ANSI.
ConvertInterfaceLuidToNameW Konwertuje identyfikator LUID dla interfejsu sieciowego na nazwę interfejsu Unicode.
ConvertInterfaceNameToLuidA Konwertuje nazwę interfejsu sieciowego ANSI na identyfikator LUID dla interfejsu.
ConvertInterfaceNameToLuidW Konwertuje nazwę interfejsu sieciowego Unicode na identyfikator LUID dla interfejsu.
if_indextoname Konwertuje indeks lokalny dla interfejsu sieciowego na nazwę interfejsu ANSI.
if_nametoindex Konwertuje nazwę interfejsu ANSI dla interfejsu sieciowego na lokalny indeks interfejsu.

Funkcje zarządzania interfejsem

Funkcja Opis
GetIfEntry2 Pobiera informacje o określonym interfejsie na komputerze lokalnym.
GetIfStackTable Pobiera tabelę wpisów wierszowych stosu interfejsów sieciowych, które określają relację między interfejsami sieciowymi w stosie.
GetIfTable2 Pobiera tabelę interfejsu MIB-II.
GetIfTable2Ex Pobiera tabelę interfejsu MIB-II, uwzględniając poziom informacji o interfejsie, który ma zostać pobrany.
getInvertedIfStackTable Pobiera tabelę odwróconych wpisów wierszy stosu interfejsu sieciowego, które określają relację interfejsów sieciowych na stosie interfejsu.
GetIpInterfaceEntry Pobiera informacje o adresie IP dla określonego interfejsu na komputerze lokalnym.
GetIpInterfaceTable Pobiera wpisy interfejsu IP na komputerze lokalnym.
InitializeIpInterfaceEntry Inicjuje elementy członkowskie wpisu struktury MIB_IPINTERFACE_ROW z wartościami domyślnymi.
SetIpInterfaceEntry Ustawia właściwości interfejsu IP na komputerze lokalnym.

Funkcje zarządzania adresami IP

Funkcja Opis
UtwórzWpisAdresemIPAnycast Dodaje nowy wpis adresu IP anycast na komputerze lokalnym.
CreateSortedAddressPairs Paruje podaną listę adresów docelowych wraz z lokalnymi adresami IP maszyny hosta i sortuje pary zgodnie z preferowaną kolejnością komunikacji.
CreateUnicastIpAddressEntry Dodaje nowy wpis adresu IP typu unicast na komputerze lokalnym.
DeleteAnycastIpAddressEntry Usuwa istniejący wpis adresu IP anycast z komputera lokalnego.
DeleteUnicastIpAddressEntry Usuwa istniejący wpis adresu IP unicast z lokalnego komputera.
GetAnycastIpAddressEntry Pobiera informacje o istniejącym wpisie adresu IP anycast na komputerze lokalnym.
GetAnycastIpAddressTable Pobiera tabelę adresów IP anycast na komputerze lokalnym.
GetMulticastIpAddressEntry Pobiera informacje dotyczące istniejącego wpisu adresu IP multicast na komputerze lokalnym.
getMulticastIpAddressTable Pobiera tabelę adresów IP multiemisji na komputerze lokalnym.
GetUnicastIpAddressEntry Pobiera informacje dotyczące istniejącego wpisu adresu IP unicast na lokalnym komputerze.
GetUnicastIpAddressTable Pobiera tabelę adresów IP unicast na komputerze lokalnym.
InitializeUnicastIpAddressEntry Inicjuje strukturę MIB_UNICASTIPADDRESS_ROW z domyślnymi wartościami dla wpisu adresu IP unicast na komputerze lokalnym.
NotifyStableUnicastIpAddressTable Pobiera stałą tabelę adresów IP unicast na lokalnym komputerze.
SetUnicastIpAddressEntry Ustawia właściwości wpisu istniejącego adresu IP jednokierunkowego na komputerze lokalnym.

Funkcje zarządzania adresami sąsiadów w protokole IP

Funkcja Opis
CreateIpNetEntry2 Tworzy nowy wpis adresu IP sąsiada na komputerze lokalnym.
DeleteIpNetEntry2 Usuwa wpis adresu IP sąsiada z komputera lokalnego.
FlushIpNetTable2 Opróżnia tabelę sąsiadów IP na komputerze lokalnym.
GetIpNetEntry2 Pobiera informacje dotyczące wpisu adresu IP sąsiada na komputerze lokalnym.
GetIpNetTable2 Pobiera tabelę sąsiadów IP na komputerze lokalnym.
ResolveIpNetEntry2 Rozpoznaje adres fizyczny dla wpisu adresu IP sąsiada na komputerze lokalnym.
SetIpNetEntry2 Ustawia fizyczny adres istniejącego wpisu adresu IP sąsiada na komputerze lokalnym.

Funkcje zarządzania ścieżkami IP

Funkcja Opis
FlushIpPathTable Opróżnia tabelę ścieżek IP na komputerze lokalnym.
GetIpPathEntry Pobiera informacje dotyczące wpisu ścieżki adresu IP na komputerze lokalnym.
getIpPathTable Pobiera informacje dotyczące tabeli ścieżek IP na komputerze lokalnym.

Funkcje zarządzania trasami IP

Funkcja Opis
CreateIpForwardEntry2 Tworzy nowy wpis trasy IP na komputerze lokalnym.
DeleteIpForwardEntry2 Usuwa wpis trasy IP z komputera lokalnego.
GetBestRoute2 Pobiera wpis trasy IP na komputerze lokalnym, aby uzyskać najlepszą trasę do określonego docelowego adresu IP.
GetIpForwardEntry2 Pobiera informacje dotyczące wpisu trasy IP na komputerze lokalnym.
GetIpForwardTable2 Pobiera wpisy trasy IP na komputerze lokalnym.
InitializeIpForwardEntry Inicjuje strukturę MIB_IPFORWARD_ROW2 z wartościami domyślnymi dla wpisu trasy IP na komputerze lokalnym.
SetIpForwardEntry2 Ustawia właściwości wpisu trasy IP na komputerze lokalnym.

Funkcje zarządzania pamięcią tabeli ADRESÓW IP

Funkcja Opis
FreeMibTable Zwalnia bufor przydzielany przez funkcje zwracające tabele interfejsów sieciowych, adresów i tras (na przykład GetIfTable2 i GetAnycastIpAddressTable).

Funkcje powiadomień

Funkcja Opis
CancelMibChangeNotify2 Wyrejestrowuje sterownik dla powiadomień o zmianach interfejsu IP, zmianach adresu IP, zmianach trasy IP oraz żądaniach pobrania stabilnej tabeli adresów IP unicast.
NotifyIpInterfaceChange Rejestruje sterownik, który ma być powiadamiany o zmianach we wszystkich interfejsach IP, interfejsach IPv4 lub interfejsach IPv6 na komputerze lokalnym.
NotifyRouteChange2 Rejestruje się, aby otrzymywać powiadomienia o zmianach w wpisach tras IP na komputerze lokalnym.
NotifyUnicastIpAddressChange Rejestruje się, aby otrzymywać powiadomienia o zmianach we wszystkich interfejsach IP emisji pojedynczej, adresach IPv4 emisji pojedynczej lub adresach IPv6 emisji pojedynczej na komputerze lokalnym.

Funkcje zarządzania klientami teredo IPv6

Funkcja Opis
GetTeredoPort Pobiera dynamiczny numer portu UDP używany przez klienta Teredo na komputerze lokalnym.
NotifyTeredoPortChange Rejestruje się, aby otrzymywać powiadomienia o zmianach w numerze portu UDP używanym przez klienta Teredo dla portu usługi Teredo na komputerze lokalnym.
NotifyStableUnicastIpAddressTable Pobiera stabilną tabelę adresów IP unicast na komputerze lokalnym.

Struktury MIB

Struktura Opis
PREFIKS_ADRESU_IP Przechowuje prefiks adresu IP.
MIB_ANYCASTIPADDRESS_ROW Przechowuje informacje o dowolnym adresie IP anycast.
MIB_ANYCASTIPADDRESS_TABLE Zawiera tabelę wpisów adresów IP typu anycast.
MIB_IF_ROW2 Przechowuje informacje o określonym interfejsie.
MIB_IF_TABLE2 Zawiera tabelę wpisów interfejsu logicznego i fizycznego.
MIB_IFSTACK_ROW Reprezentuje relację między dwoma interfejsami sieciowymi.
MIB_IFSTACK_TABLE Zawiera tabelę rekordów wierszy w stosie interfejsu sieciowego. Ta tabela określa relację interfejsów sieciowych na stosie interfejsu.
MIB_INVERTEDIFSTACK_ROW Reprezentuje relację między dwoma interfejsami sieciowymi.
MIB_INVERTEDIFSTACK_TABLE Zawiera tabelę wpisów stosu interfejsu sieciowego w odwrotnej kolejności. Ta tabela określa relację interfejsów sieciowych na stosie interfejsu w odwrotnej kolejności.
MIB_IPFORWARD_ROW2 Przechowuje informacje o wpisie trasy IP.
MIB_IPFORWARD_TABLE2 Zawiera tabelę wpisów tras IP.
MIB_IPINTERFACE_ROW Przechowuje informacje o zarządzaniu interfejsem dla określonej rodziny adresów IP w interfejsie sieciowym.
MIB_IPINTERFACE_TABLE Zawiera tabelę wpisów interfejsu IP.
MIB_IPNET_ROW2 Przechowuje informacje o sąsiednim adresie IP.
MIB_IPNET_TABLE2 Zawiera tabelę wpisów adresu IP sąsiada.
MIB_IPPATH_ROW Przechowuje informacje o wpisie ścieżki IP.
MIB_IPPATH_TABLE Zawiera tabelę wpisów ścieżki IP.
MIB_MULTICASTIPADDRESS_ROW Przechowuje informacje o adresie IP multicast.
MIB_MULTICASTIPADDRESS_TABLE Zawiera tabelę wpisów adresów IP multicast.
MIB_UNICASTIPADDRESS_ROW Przechowuje informacje o adresie IP unicast.
MIB_UNICASTIPADDRESS_TABLE Zawiera tabelę zawierającą wpisy adresów IP unicast.

Wyliczenia MIB

Wyliczenie Opis
MIB_IF_TABLE_LEVEL Określa poziom informacji o interfejsie, które należy pobrać.
MIB_NOTIFICATION_TYPE Definiuje typ powiadomienia, który jest przekazywany do funkcji wywołania zwrotnego po wystąpieniu powiadomienia.

Wyliczenia NL

Wyliczenie Opis
NL_ADDRESS_TYPE Określa typ adresu IP warstwy sieciowej.
NL_DAD_STATE Definiuje stan wykrywania zduplikowanych adresów (DAD).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR Definiuje zachowanie lokalnego adresu łącza.
NL_NEIGHBOR_STATE Definiuje stan adresu IP sąsiada warstwy sieciowej, zgodnie z opisem w artykule RFC 2461, sekcja 7.3.2.
NL_PREFIX_ORIGIN Definiuje początek prefiksu lub części sieciowej adresu IP.
NL_ROUTE_ORIGIN Definiuje początek trasy IP.
NL_ROUTE_PROTOCOL Definiuje mechanizm routingu, za pomocą którego dodano trasę IP, zgodnie z opisem w RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR Definiuje zachowanie odnajdywania routera zgodnie z opisem w specyfikacji RFC 2461.
NL_SUFFIX_ORIGIN Definiuje początek sufiksu lub części hosta adresu IP.