IP-Helper-Übersicht

Das Internetprotokollhilfsprogramm (IP-Hilfsprogramm) ermöglicht Treibern das Abrufen von Informationen zur Netzwerkkonfiguration des lokalen Computers und zum Ändern dieser Konfiguration. IP-Hilfsprogramm bietet auch Mechanismen zur Benachrichtigung, um sicherzustellen, dass ein Treiber informiert wird, wenn sich bestimmte Aspekte der Netzwerkkonfiguration eines lokalen Computers ändern. IP-Hilfsprogramm ist in Windows Vista und höheren Versionen von Microsoft Windows-Betriebssystemen verfügbar.

Viele der IP-Hilfsfunktionen übergeben Strukturparameter, die Datentypen darstellen, die der MIB-Technologie (Management Information Base) zugeordnet sind. Die IP-Hilfsfunktionen verwenden diese MIB-Strukturen, um verschiedene Netzwerkinformationen darzustellen.

Die IP-Hilfsdokumentation verwendet die Begriffe Adapter und Schnittstelle häufig. Ein Adapter ist ein veralteter Begriff, der eine abgekürzte Form von Netzwerkadapter ist, der sich ursprünglich auf eine Form von Netzwerkhardware bezog. Ein Adapter ist eine Abstraktion auf dem Data-Link-Layer.

Eine Schnittstelle wird in den RFC-Dokumenten der IETF als abstraktes Konzept beschrieben, das die Anbindung eines Knotens an einen Link darstellt. Eine Schnittstelle ist eine Abstraktion auf IP-Ebene.

Ihr Treiber kann die folgenden Kernel-Mode-Funktionen, MIB-Strukturen und MIB- und Networking-Schicht (NL)-Auflistungen verwenden, um Konfigurationseinstellungen für den Transmission Control Protocol/Internet Protocol (TCP/IP)-Transport auf einem lokalen Computer abzurufen und zu ändern.

Anmerkung

Wenn Sie Treiber-Code entwickeln, folgen Sie den Anweisungen zum Einbinden von Header-Dateien.

Funktionen zur Schnittstellenkonvertierung

Funktion	Beschreibung
ConvertInterfaceAliasToLuid	Konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den Unicode-Schnittstellennamen.
ConvertInterfaceGuidToLuid	Konvertiert einen global eindeutigen Bezeichner (GUID) für eine Netzwerkschnittstelle in die LUID für die Schnittstelle.
ConvertInterfaceIndexToLuid	Konvertiert einen lokalen Index für eine Netzwerkschnittstelle in die LUID für die Schnittstelle.
ConvertInterfaceLuidToAlias	Konvertiert eine LUID für eine Netzwerkschnittstelle in einen Schnittstellen-Alias.
ConvertInterfaceLuidToGuid	Konvertiert eine LUID für eine Netzwerkschnittstelle in eine GUID für die Schnittstelle.
ConvertInterfaceLuidToIndex	Konvertiert eine LUID für eine Netzwerkschnittstelle in den lokalen Index für die Schnittstelle.
ConvertInterfaceLuidToNameA	Konvertiert eine LUID für eine Netzwerkschnittstelle in den ANSI-Schnittstellennamen.
ConvertInterfaceLuidToNameW	Konvertiert eine LUID für eine Netzwerkschnittstelle in den Unicode-Schnittstellennamen.
ConvertInterfaceNameToLuidA	Konvertiert einen ANSI-Netzwerkschnittstellennamen in die LUID für die Schnittstelle.
ConvertInterfaceNameToLuidW	Konvertiert einen Unicode-Netzwerkschnittstellennamen in die LUID für die Schnittstelle.
if_indextoname	Konvertiert den lokalen Index für eine Netzwerkschnittstelle in den ANSI-Schnittstellennamen.
if_nametoindex	Konvertiert den ANSI-Schnittstellennamen für eine Netzwerkschnittstelle in den lokalen Index für die Schnittstelle.

Schnittstellenverwaltungsfunktionen

Funktion	Beschreibung
GetIfEntry2	Ruft Informationen für die angegebene Schnittstelle auf dem lokalen Computer ab.
GetIfStackTable	Ruft eine Tabelle mit Netzwerkschnittstellen-Stack-Zeileneinträgen ab, die die Beziehung der Netzwerkschnittstellen auf einem Schnittstellen-Stack angeben.
GetIfTable2	Ruft die MIB-II-Schnittstellentabelle ab.
GetIfTable2Ex	Ruft die MIB-II-Schnittstellentabelle ab, wenn Sie eine Ebene von Schnittstelleninformationen angeben, die abgerufen werden sollen.
GetInvertedIfStackTable	Ruft eine Tabelle mit invertierten Netzwerkschnittstellen-Stack-Zeileneinträgen ab, die die Beziehung der Netzwerkschnittstellen auf einem Schnittstellen-Stack angeben.
GetIpInterfaceEntry	Ruft IP-Informationen für die angegebene Schnittstelle auf dem lokalen Computer ab.
GetIpInterfaceTable	Ruft die IP-Schnittstelleneinträge auf dem lokalen Computer ab.
InitializeIpInterfaceEntry	Initialisiert die Mitglieder eines MIB_IPINTERFACE_ROW-Struktureintrags mit Standardwerten.
SetIpInterfaceEntry	Legt die Eigenschaften einer IP-Schnittstelle auf dem lokalen Computer fest.

IP-Adressverwaltungsfunktionen

Funktion	Beschreibung
CreateAnycastIpAddressEntry	Fügt einen neuen Eintrag für eine Anycast-IP-Adresse auf dem lokalen Computer hinzu.
CreateSortedAddressPairs	Koppelt eine angegebene Liste von Zieladressen zusammen mit den lokalen IP-Adressen des Hostcomputers und sortiert die Paare nach der bevorzugten Kommunikationsreihenfolge.
CreateUnicastIpAddressEntry	Fügt einen neuen Eintrag für eine Unicast-IP-Adresse auf dem lokalen Computer hinzu.
DeleteAnycastIpAddressEntry	Löscht einen vorhandenen Anycast-IP-Adresseintrag vom lokalen Computer.
DeleteUnicastIpAddressEntry	Löscht einen vorhandenen Unicast-IP-Adresseintrag vom lokalen Computer.
GetAnycastIpAddressEntry	Ruft Informationen zu einem vorhandenen Eintrag für eine Anycast-IP-Adresse auf dem lokalen Computer ab.
GetAnycastIpAddressTable	Ruft die Anycast-IP-Adresstabelle auf dem lokalen Computer ab.
GetMulticastIpAddressEntry	Ruft Informationen zu einem vorhandenen Multicast-IP-Adresseintrag auf dem lokalen Computer ab.
GetMulticastIpAddressTable	Ruft die Tabelle der Multicast-IP-Adressen auf dem lokalen Computer ab.
GetUnicastIpAddressEntry	Ruft Informationen zu einem vorhandenen Unicast-IP-Adresseintrag auf dem lokalen Computer ab.
GetUnicastIpAddressTable	Ruft die Unicast-IP-Adresstabelle auf dem lokalen Computer ab.
InitializeUnicastIpAddressEntry	Initialisiert eine MIB_UNICASTIPADDRESS_ROW-Struktur mit Standardwerten für einen Unicast-IP-Adresseintrag auf dem lokalen Computer.
NotifyStableUnicastIpAddressTable	Ruft die stabile Unicast-IP-Adresstabelle auf einem lokalen Computer ab.
SetUnicastIpAddressEntry	Legt die Eigenschaften eines vorhandenen Unicast-IP-Adresseintrags auf dem lokalen Computer fest.

Funktionen zur Verwaltung von IP-Adressen von Nachbarn

Funktion	Beschreibung
CreateIpNetEntry2	Erstellt einen neuen Eintrag für die IP-Adresse des Nachbarn auf dem lokalen Computer.
DeleteIpNetEntry2	Löscht einen Ip-Adresseintrag des Nachbarn vom lokalen Computer.
FlushIpNetTable2	Löscht die IP-Nachbar-Tabelle auf dem lokalen Computer.
GetIpNetEntry2	Ruft Informationen zu einem Eintrag für eine IP-Adresse eines Nachbarn auf dem lokalen Computer ab.
GetIpNetTable2	Ruft die IP-Nachbartabelle auf dem lokalen Computer ab.
ResolveIpNetEntry2	Löst die physikalische Adresse für einen IP-Nachbaradresseintrag auf dem lokalen Computer auf.
SetIpNetEntry2	Legt die physische Adresse eines bestehenden IP-Nachbaradresseintrags auf dem lokalen Computer fest.

IP-Pfad-Verwaltungsfunktionen

Funktion	Beschreibung
FlushIpPathTable	Löscht die IP-Pfad-Tabelle auf dem lokalen Computer.
GetIpPathEntry	Ruft Informationen zu einem IP-Pfad-Eintrag auf dem lokalen Computer ab.
GetIpPathTable	Ruft Informationen für eine IP-Pfad-Tabelle auf dem lokalen Computer ab.

IP-Routenverwaltungsfunktionen

Funktion	Beschreibung
CreateIpForwardEntry2	Erstellt einen neuen IP-Routeneintrag auf dem lokalen Computer.
DeleteIpForwardEntry2	Löscht einen IP-Routeneintrag vom lokalen Computer.
GetBestRoute2	Ruft den IP-Routeneintrag auf dem lokalen Computer ab, um die beste Route zur angegebenen Ziel-IP-Adresse zu erzielen.
GetIpForwardEntry2	Ruft Informationen für einen IP-Route-Eintrag auf dem lokalen Computer ab.
GetIpForwardTable2	Ruft die IP-Routeneinträge auf dem lokalen Computer ab.
InitializeIpForwardEntry	Initialisiert eine MIB_IPFORWARD_ROW2-Struktur mit Standardwerten für einen IP-Route-Eintrag auf dem lokalen Computer.
SetIpForwardEntry2	Legt die Eigenschaften eines IP-Routeneintrags auf dem lokalen Computer fest.

Speicherverwaltungsfunktionen für IP-Tabellen

Funktion	Beschreibung
FreeMibTable	Gibt den Puffer frei, der durch die Funktionen zugewiesen wird, die Tabellen mit Netzwerkschnittstellen, Adressen und Routen zurückgeben (z. B. GetIfTable2 und GetAnycastIpAddressTable).

Benachrichtigungsfunktionen

Funktion	Beschreibung
CancelMibChangeNotify2	Hebt die Registrierung des Treibers für Änderungsbenachrichtigungen für IP-Schnittstellenänderungen, IP-Adressenänderungen, IP-Routenänderungen und Anfragen zum Abruf der stabilen Unicast-IP-Adresstabelle auf.
NotifyIpInterfaceChange	Registriert den Treiber, um bei Änderungen an allen IP-Schnittstellen, IPv4-Schnittstellen oder IPv6-Schnittstellen auf einem lokalen Computer benachrichtigt zu werden.
NotifyRouteChange2	Registriert für die Benachrichtigung bei Änderungen von IP-Routeneinträgen auf einem lokalen Computer.
NotifyUnicastIpAddressChange	Registriert für die Benachrichtigung bei Änderungen an allen Unicast-IP-Schnittstellen, Unicast-IPv4-Adressen oder Unicast-IPv6-Adressen auf einem lokalen Computer.

Teredo IPv6-Clientverwaltungsfunktionen

Funktion	Beschreibung
GetTeredoPort	Ruft die dynamische UDP-Portnummer ab, die der Teredo-Client auf dem lokalen Computer verwendet.
NotifyTeredoPortChange	Registriert für die Benachrichtigung bei Änderungen der UDP-Port-Nummer, die der Teredo-Client für den Teredo-Dienst-Port auf einem lokalen Computer verwendet.
NotifyStableUnicastIpAddressTable	Ruft die stabile Unicast-IP-Adresstabelle auf einem lokalen Computer ab.

MIB-Strukturen

Struktur	Beschreibung
IP_ADDRESS_PREFIX	Speichert ein IP-Adresspräfix.
MIB_ANYCASTIPADDRESS_ROW	Speichert Informationen zu einer Anycast-IP-Adresse.
MIB_ANYCASTIPADDRESS_TABLE	Enthält eine Tabelle mit Anycast-IP-Adresseinträgen.
MIB_IF_ROW2	Speichert Informationen zu einer bestimmten Schnittstelle.
MIB_IF_TABLE2	Enthält eine Tabelle mit logischen und physischen Schnittstelleneinträgen.
MIB_IFSTACK_ROW	Stellt die Beziehung zwischen zwei Netzwerkschnittstellen dar.
MIB_IFSTACK_TABLE	Enthält eine Tabelle mit Zeileneinträgen im Netzwerkschnittstellen-Stack. Diese Tabelle gibt die Beziehung der Netzwerkschnittstellen in einem Schnittstellenstapel an.
MIB_INVERTEDIFSTACK_ROW	Stellt die Beziehung zwischen zwei Netzwerkschnittstellen dar.
MIB_INVERTEDIFSTACK_TABLE	Enthält eine Tabelle mit invertierten Zeileneinträgen im Netzwerkschnittstellen-Stack. Diese Tabelle gibt die Beziehung der Netzwerkschnittstellen auf einem Schnittstellenstapel in umgekehrter Reihenfolge an.
MIB_IPFORWARD_ROW2	Speichert Informationen über einen IP-Route-Eintrag.
MIB_IPFORWARD_TABLE2	Enthält eine Tabelle mit IP-Routeneinträgen.
MIB_IPINTERFACE_ROW	Speichert Schnittstellenverwaltungsinformationen für eine bestimmte IP-Adressfamilie auf einer Netzwerkschnittstelle.
MIB_IPINTERFACE_TABLE	Enthält eine Tabelle mit IP-Schnittstelleneinträgen.
MIB_IPNET_ROW2	Speichert Informationen zu einer benachbarten IP-Adresse.
MIB_IPNET_TABLE2	Enthält eine Tabelle mit Ip-Adresseinträgen des Nachbarn.
MIB_IPPATH_ROW	Speichert Informationen über einen IP-Pfad-Eintrag.
MIB_IPPATH_TABLE	Enthält eine Tabelle mit Einträgen zu IP-Pfaden.
MIB_MULTICASTIPADDRESS_ROW	Speichert Informationen über eine Multicast-IP-Adresse.
MIB_MULTICASTIPADDRESS_TABLE	Enthält eine Tabelle mit Multicast-IP-Adresseinträgen.
MIB_UNICASTIPADDRESS_ROW	Speichert Informationen zu einer Unicast-IP-Adresse.
MIB_UNICASTIPADDRESS_TABLE	Enthält eine Tabelle mit Unicast-IP-Adresseinträgen.

MIB-Auflistungen

Enumeration	Beschreibung
MIB_IF_TABLE_LEVEL	Definiert das Niveau der Schnittstelleninformationen, die abgerufen werden sollen.
MIB_NOTIFICATION_TYPE	Definiert den Benachrichtigungstyp, der an eine Callback-Funktion übergeben wird, wenn eine Benachrichtigung auftritt.

NL-Auflistungen

Enumeration	Beschreibung
NL_ADDRESS_TYPE	Gibt den IP-Adresstyp der Netzwerkebene an.
NL_DAD_STATE	Definiert den DAD-Status (Duplicate Address Detection).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR	Definiert das Verhalten der Link-Local-Adresse.
NL_NEIGHBOR_STATE	Definiert den Status einer Nachbar-IP-Adresse der Netzwerkschicht, wie in RFC 2461, Abschnitt 7.3.2 beschrieben.
NL_PREFIX_ORIGIN	Definiert den Ursprung des Präfix- oder Netzwerkteils der IP-Adresse.
NL_ROUTE_ORIGIN	Definiert den Ursprung der IP-Route.
NL_ROUTE_PROTOCOL	Definiert den Routingmechanismus, mit dem eine IP-Route hinzugefügt wurde, wie in RFC 4292 beschrieben.
NL_ROUTER_DISCOVERY_BEHAVIOR	Definiert das Verhalten bei der Router-Erkennung, wie in RFC 2461 beschrieben.
NL_SUFFIX_ORIGIN	Definiert den Ursprung des Suffixes oder des Hostteils der IP-Adresse.