Översikt över IP-hjälpen
Internet Protocol Helper (IP Helper) gör det möjligt för drivrutiner att hämta information om den lokala datorns nätverkskonfiguration och ändra den konfigurationen. IP-hjälpen tillhandahåller också meddelandemekanismer för att se till att en drivrutin meddelas när vissa aspekter av den lokala datorns nätverkskonfiguration ändras. IP-hjälpen är tillgänglig i Windows Vista och senare versioner av Microsoft Windows-operativsystemen.
Många av IP-hjälpfunktionerna skickar strukturparametrar som representerar datatyper som är associerade med MIB-tekniken (Management Information Base). IP-hjälpfunktionerna använder dessa MIB-strukturer för att representera olika nätverksinformation.
I DOKUMENTATIONen för IP-hjälpen används termerna adapter och gränssnitt i stor utsträckning. Ett kort är en äldre term som är en förkortad form av nätverkskort, som ursprungligen hänvisade till någon form av nätverksmaskinvara. En adapter är en abstraktion på datalänknivå.
Ett gränssnitt beskrivs i IETF RFC-dokumenten som ett abstrakt begrepp som representerar en nods anslutning till en länk. Ett gränssnitt är en abstraktion på IP-nivå.
Drivrutinen kan använda följande kernellägesfunktioner, MIB-strukturer och uppräkningar för MIB och nätverksnivå (NL) för att hämta och ändra konfigurationsinställningarna för överföringskontrollprotokoll/TCP/IP-transport (TCP/IP) på en lokal dator.
Notera
När du utvecklar drivrutinskoden följer du anvisningarna för inklusive huvudfiler.
Gränssnittskonverteringsfunktioner
| Funktion | Beskrivning |
|---|---|
| ConvertInterfaceAliasToLuid | Konverterar en lokalt unik identifierare (LUID) för ett nätverksgränssnitt till Unicode-gränssnittets namn. |
| ConvertInterfaceGuidToLuid | Konverterar en globalt unik identifierare (GUID) för ett nätverksgränssnitt till LUID för gränssnittet. |
| ConvertInterfaceIndexToLuid | Konverterar ett lokalt index för ett nätverksgränssnitt till LUID för gränssnittet. |
| ConvertInterfaceLuidToAlias | Konverterar ett LUID för ett nätverksgränssnitt till ett gränssnittsalias. |
| ConvertInterfaceLuidToGuid | Konverterar ett LUID för ett nätverksgränssnitt till ett GUID för gränssnittet. |
| ConvertInterfaceLuidToIndex | Konverterar ett LUID för ett nätverksgränssnitt till det lokala indexet för gränssnittet. |
| ConvertInterfaceLuidToNameA | Konverterar ett LUID för ett nätverksgränssnitt till ANSI-gränssnittets namn. |
| ConvertInterfaceLuidToNameW | Konverterar ett LUID för ett nätverksgränssnitt till Unicode-gränssnittets namn. |
| ConvertInterfaceNameToLuidA | Konverterar ett ANSI-nätverksgränssnittsnamn till LUID för gränssnittet. |
| ConvertInterfaceNameToLuidW | Konverterar ett Unicode-nätverksgränssnittsnamn till LUID för gränssnittet. |
| if_indextoname | Konverterar det lokala indexet för ett nätverksgränssnitt till NAMNET på ANSI-gränssnittet. |
| if_nametoindex | Konverterar ANSI-gränssnittsnamnet för ett nätverksgränssnitt till det lokala indexet för gränssnittet. |
Gränssnittshanteringsfunktioner
| Funktion | Beskrivning |
|---|---|
| GetIfEntry2 | Hämtar information för det angivna gränssnittet på den lokala datorn. |
| GetIfStackTable | Hämtar en tabell med radposter i nätverksgränssnittet som anger relationen mellan nätverksgränssnitten i en gränssnittsstack. |
| GetIfTable2 | Hämtar MIB-II-gränssnittstabellen. |
| GetIfTable2Ex | Hämtar MIB-II-gränssnittstabellen med en nivå av gränssnittsinformation som ska hämtas. |
| GetInvertedIfStackTable | Hämtar en tabell med inverterade radposter i nätverksgränssnittet som anger relationen mellan nätverksgränssnitten i en gränssnittsstack. |
| GetIpInterfaceEntry | Hämtar IP-information för det angivna gränssnittet på den lokala datorn. |
| GetIpInterfaceTable | Hämtar IP-gränssnittsposterna på den lokala datorn. |
| InitializeIpInterfaceEntry | Initierar medlemmarna i en struktur av typen MIB_IPINTERFACE_ROW med standardvärden. |
| SetIpInterfaceEntry | Anger egenskaperna för ett IP-gränssnitt på den lokala datorn. |
Hanteringsfunktioner för IP-adresser
| Funktion | Beskrivning |
|---|---|
| CreateAnycastIpAddressEntry | Lägger till en ny anycast IP-adresspost på den lokala datorn. |
| CreateSortedAddressPairs | Parar ihop en angiven lista med måladresser tillsammans med värddatorns lokala IP-adresser och sorterar paren enligt önskad kommunikationsordning. |
| CreateUnicastIpAddressEntry | Lägger till en ny unicast-IP-adressinmatning på den lokala datorn. |
| DeleteAnycastIpAddressEntry | Tar bort en befintlig anycast IP-adress från den lokala datorn. |
| DeleteUnicastIpAddressEntry | Tar bort en befintlig unicast-IP-adresspost från den lokala datorn. |
| GetAnycastIpAddressEntry | Hämtar information för en befintlig anycast IP-adresspost på den lokala datorn. |
| GetAnycastIpAddressTable | Hämtar tabellen för anycast-IP-adresser på den lokala datorn. |
| GetMulticastIpAddressEntry | Hämtar information om en befintlig multicast-IP-adresspostering på den lokala datorn. |
| GetMulticastIpAddressTable | Hämtar multicast-IP-adresstabellen på den lokala datorn. |
| GetUnicastIpAddressEntry | Hämtar information för en befintlig unicast-IP-adresspost på den lokala datorn. |
| GetUnicastIpAddressTable | Hämtar unicast IP-adresstabellen på den lokala datorn. |
| InitializeUnicastIpAddressEntry | Initierar en MIB_UNICASTIPADDRESS_ROW-struktur med standardvärden för en unicast-IP-adresspostering på den lokala datorn. |
| NotifyStableUnicastIpAddressTable | Hämtar den stabila unicast-IP-adresstabellen på en lokal dator. |
| SetUnicastIpAddressEntry | Anger egenskaperna för en befintlig unicast-IP-adresspost på den lokala datorn. |
Hantering av IP-grannadress
| Funktion | Beskrivning |
|---|---|
| CreateIpNetEntry2 | Skapar en ny granner IP-adressinmatning på den lokala datorn. |
| DeleteIpNetEntry2 | Tar bort en angränsande IP-adresspost från den lokala datorn. |
| FlushIpNetTable2 | Tömer tabellen IP-granne på den lokala datorn. |
| GetIpNetEntry2 | Hämtar information för en grannes IP-adress på den lokala datorn. |
| GetIpNetTable2 | Hämtar IP-nabogränstabellen på den lokala datorn. |
| ResolveIpNetEntry2 | Löser den fysiska adressen för en grannes IP-adresspostering på den lokala datorn. |
| SetIpNetEntry2 | Anger den fysiska adressen för en befintlig nätverksgrannes IP-post på den lokala datorn. |
Hanteringsfunktioner för IP-sökväg
| Funktion | Beskrivning |
|---|---|
| FlushIpPathTable | Rensar IP-sökvägstabellen på den lokala datorn. |
| GetIpPathEntry | Hämtar information för en IP-sökvägspost på den lokala datorn. |
| GetIpPathTable | Hämtar information för en IP-sökvägstabell på den lokala datorn. |
Hanteringsfunktioner för IP-routning
| Funktion | Beskrivning |
|---|---|
| CreateIpForwardEntry2 | Skapar en ny IP-routning på den lokala datorn. |
| DeleteIpForwardEntry2 | Tar bort en IP-vägpost från den lokala datorn. |
| GetBestRoute2 | Hämtar IP-väginträdet i den lokala datorn för den bästa vägen till den specificerade IP-adressen för destinationen. |
| GetIpForwardEntry2 | Hämtar information om en IP-ruttpost på den lokala datorn. |
| GetIpForwardTable2 | Hämtar IP-ruttposterna på den lokala datorn. |
| InitializeIpForwardEntry | Initierar en MIB_IPFORWARD_ROW2 struktur med standardvärden för en IP-vägpost på den lokala datorn. |
| SetIpForwardEntry2 | Anger egenskaperna för en IP-vägpost på den lokala datorn. |
Minneshanteringsfunktioner för IP-tabell
| Funktion | Beskrivning |
|---|---|
| FreeMibTable | Frigör bufferten som allokeras av de funktioner som returnerar tabeller med nätverksgränssnitt, adresser och vägar (till exempel GetIfTable2 och GetAnycastIpAddressTable). |
Meddelandefunktioner
| Funktion | Beskrivning |
|---|---|
| CancelMibChangeNotify2 | Avregistrerar drivrutinen för ändringsmeddelanden för IP-gränssnittsändringar, IP-adressändringar, IP-vägändringar och begäranden om att hämta den stabila unicast-IP-adresstabellen. |
| NotifyIpInterfaceChange | Registrerar drivrutinen för att bli meddelad om ändringar i alla IP-gränssnitt, IPv4-gränssnitt eller IPv6-gränssnitt på en lokal dator. |
| NotifyRouteChange2 | Registrerar sig för aviseringar om ändringar av IP-routningsposter på en lokal dator. |
| Meddela omändring av Unicast IP-adress | Registrerar sig för ändringar i alla unicast IP-gränssnitt, unicast IPv4-adresser eller unicast IPv6-adresser på en lokal dator. |
Teredo IPv6-klienthanteringsfunktioner
| Funktion | Beskrivning |
|---|---|
| GetTeredoPort | Hämtar det dynamiska UDP-portnumret som Teredo-klienten använder på den lokala datorn. |
| NotifyTeredoPortChange | Anmäler sig för att få aviseringar om ändringar av UDP-portnumret som Teredo-klienten använder för Teredo-tjänstporten på en lokal dator. |
| NotifyStableUnicastIpAddressTable | Hämtar den stabila unicast-IP-adresstabellen på en lokal dator. |
MIB-strukturer
| Struktur | Beskrivning |
|---|---|
| IP_ADDRESS_PREFIX | Lagrar ett IP-adressprefix. |
| MIB_ANYCASTIPADDRESS_ROW | Lagrar information om en anycast IP-adress. |
| MIB_ANYCASTIPADDRESS_TABLE | Innehåller en tabell med anycast IP-adressposter. |
| MIB_IF_ROW2 | Lagrar information om ett visst gränssnitt. |
| MIB_IF_TABLE2 | Innehåller en tabell med logiska och fysiska gränssnittsposter. |
| MIB_IFSTACK_ROW | Representerar relationen mellan två nätverksgränssnitt. |
| MIB_IFSTACK_TABLE | Innehåller en tabell med radposter i nätverksgränssnittsstacken. Den här tabellen anger relationen mellan nätverksgränssnitten i en gränssnittsstack. |
| MIB_INVERTEDIFSTACK_ROW | Representerar relationen mellan två nätverksgränssnitt. |
| MIB_INVERTEDIFSTACK_TABLE | Innehåller en tabell över poster i den inverterade nätverksgränssnittsstacken. Den här tabellen anger relationen mellan nätverksgränssnitten i en gränssnittsstack i omvänd ordning. |
| MIB_IPFORWARD_ROW2 | Lagrar information om en IP-vägpost. |
| MIB_IPFORWARD_TABLE2 | Innehåller en tabell med IP-routningsposter. |
| MIB_IPINTERFACE_ROW | Lagrar gränssnittshanteringsinformation för en viss IP-adressfamilj i ett nätverksgränssnitt. |
| MIB_IPINTERFACE_TABLE | Innehåller en tabell med IP-gränssnittsposter. |
| MIB_IPNET_ROW2 | Lagrar information om en grannes IP-adress. |
| MIB_IPNET_TABLE2 | Innehåller en tabell med poster över närliggande IP-adresser. |
| MIB_IPPATH_ROW | Lagrar information om en IP-sökvägspost. |
| MIB_IPPATH_TABLE | Innehåller en tabell med IP-sökvägsposter. |
| MIB_MULTICASTIPADDRESS_ROW | Lagrar information om en multicast-IP-adress. |
| MIB_MULTICASTIPADDRESS_TABLE | Innehåller en tabell med multicast-IP-adressposter. |
| MIB_UNICASTIPADDRESS_ROW | Lagrar information om en unicast-IP-adress. |
| MIB_UNICASTIPADDRESS_TABLE | Innehåller en tabell med unicast-IP-adresseringar. |
MIB-uppräkningar
| Uppräkning | Beskrivning |
|---|---|
| MIB_IF_TABLE_LEVEL | Definierar vilken nivå av gränssnittsinformation som ska hämtas. |
| MIB_NOTIFICATION_TYPE | Definierar den meddelandetyp som skickas till en återanropsfunktion när ett meddelande inträffar. |
NL-uppräkningar
| Uppräkning | Beskrivning |
|---|---|
| NL_ADDRESS_TYPE | Anger IP-adresstypen för nätverksskiktet. |
| NL_DAD_STATE | Definierar tillståndet för upptäckt av dubbla adresser (DAD). |
| NL_LINK_LOCAL_ADDRESS_BEHAVIOR | Definierar länkens lokala adressbeteende. |
| NL_NEIGHBOR_STATE | Definierar tillståndet för en ip-adress för nätverksskiktets granne enligt beskrivningen i RFC 2461, avsnitt 7.3.2. |
| NL_PREFIX_ORIGIN | Definierar ursprunget för prefixet eller nätverksdelen av IP-adressen. |
| NL_ROUTE_ORIGIN | Definierar IP-vägens ursprung. |
| NL_ROUTE_PROTOCOL | Definierar routningsmekanismen som en IP-väg lades till med, enligt beskrivningen i RFC 4292. |
| NL_ROUTER_DISCOVERY_BEHAVIOR | Definierar routeridentifieringsbeteendet enligt beskrivningen i RFC 2461. |
| NL_SUFFIX_ORIGIN | Definierar ursprunget för suffixet eller värddelen av IP-adressen. |