IP-Hilfsprogramm – Ü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 außerdem Benachrichtigungsmechanismen, um sicherzustellen, dass ein Treiber benachrichtigt wird, wenn bestimmte Aspekte der Netzwerkkonfiguration des lokalen Computers geändert werden. 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" umfassend. Ein Adapter ist ein Legacybegriff, der eine abgekürzte Form des Netzwerkadapters ist, die ursprünglich auf eine Form von Netzwerkhardware verweist. Ein Adapter ist eine Abstraktion auf Datenverknüpfungsebene.

Eine Schnittstelle wird in den IETF RFC-Dokumenten als abstraktes Konzept beschrieben, das die Anlage eines Knotens zu einem Link darstellt. Eine Schnittstelle ist eine Abstraktion auf IP-Ebene.

Ihr Treiber kann die folgenden Kernelmodusfunktionen, MIB-Strukturen und MIB- und Network Layer(NL)-Enumerationen verwenden, um Konfigurationseinstellungen für den TCP/IP-Transport (Transmission Control Protocol/ Internet Protocol) auf einem lokalen Computer abzurufen und zu ändern.

Hinweis

 Wenn Sie Treibercode entwickeln, befolgen Sie die Anweisungen zum Einschließen von Headerdateien.

Funktionen zur Schnittstellenkonvertierung

Funktion	Beschreibung
ConvertInterfaceAliasToLuid	Konvertiert eine lokal eindeutige ID (LUID) für eine Netzwerkschnittstelle in den Unicode-Schnittstellennamen.
ConvertInterfaceGuidToLuid	Konvertiert eine GUID (Globally Unique Identifier) 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 Schnittstellenalias.
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.

Funktionen der Schnittstellenverwaltung

Funktion	Beschreibung
GetIfEntry2	Ruft Informationen für die angegebene Schnittstelle auf dem lokalen Computer ab.
GetIfStackTable	Ruft eine Tabelle mit Zeileneinträgen der Netzwerkschnittstellenliste ab, die die Beziehung der Netzwerkschnittstellen in einem Schnittstellenstapel angeben.
GetIfTable2	Ruft die MIB-II-Schnittstellentabelle ab.
GetIfTable2Ex	Ruft die MIB-II-Schnittstellentabelle anhand einer Ebene von Schnittstelleninformationen ab, die abgerufen werden sollen.
GetInvertedIfStackTable	Ruft eine Tabelle mit invertierten Netzwerkschnittstellen-Stapelzeileneinträgen ab, die die Beziehung der Netzwerkschnittstellen in einem Schnittstellenstapel 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 Member 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 Anycast-IP-Adresseintrag 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 Unicast-IP-Adresseintrag auf dem lokalen Computer hinzu.
DeleteAnycastIpAddressEntry	Löscht einen vorhandenen Anycast-IP-Adresseintrag auf dem lokalen Computer.
DeleteUnicastIpAddressEntry	Löscht einen vorhandenen Unicast-IP-Adresseintrag vom lokalen Computer.
GetAnycastIpAddressEntry	Ruft Informationen für einen vorhandenen Anycast-IP-Adresseintrag auf dem lokalen Computer ab.
GetAnycastIpAddressTable	Ruft die Anycast-IP-Adresstabelle auf dem lokalen Computer ab.
GetMulticastIpAddressEntry	Ruft Informationen für einen vorhandenen Multicast-IP-Adresseintrag auf dem lokalen Computer ab.
GetMulticastIpAddressTable	Ruft die Multicast-IP-Adresstabelle auf dem lokalen Computer ab.
GetUnicastIpAddressEntry	Ruft Informationen für einen 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-Nachbaradressen

Funktion	Beschreibung
CreateIpNetEntry2	Erstellt einen neuen IP-Adresseintrag des Nachbarn auf dem lokalen Computer.
DeleteIpNetEntry2	Löscht einen Ip-Adresseintrag des Nachbarn vom lokalen Computer.
FlushIpNetTable2	Löscht die IP-Nachbartabelle auf dem lokalen Computer.
GetIpNetEntry2	Ruft Informationen für einen Ip-Adresseintrag des Nachbarn auf dem lokalen Computer ab.
GetIpNetTable2	Ruft die IP-Nachbartabelle auf dem lokalen Computer ab.
ResolveIpNetEntry2	Löst die physische Adresse für einen Ip-Adresseintrag eines Nachbarn auf dem lokalen Computer auf.
SetIpNetEntry2	Legt die physische Adresse eines vorhandenen Ip-Adresseintrags eines nachbarn auf dem lokalen Computer fest.

IP-Pfadverwaltungsfunktionen

Funktion	Beschreibung
FlushIpPathTable	Löscht die IP-Pfadtabelle auf dem lokalen Computer.
GetIpPathEntry	Ruft Informationen für einen IP-Pfadeintrag auf dem lokalen Computer ab.
GetIpPathTable	Ruft Informationen für einen IP-Pfadeintrag 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-Routeneintrag 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-Routeneintrag auf dem lokalen Computer.
SetIpForwardEntry2	Legt die Eigenschaften eines IP-Routeneintrags auf dem lokalen Computer fest.

IP-Tabellen-Speicherverwaltungsfunktionen

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

Notification-Funktionen

Funktion	Beschreibung
CancelMibChangeNotify2	Deregistert den Treiber für Änderungsbenachrichtigungen für IP-Schnittstellenänderungen, IP-Adressänderungen, IP-Routenänderungen und Anforderungen zum Abrufen der stabilen Unicast-IP-Adresstabelle.
NotifyIpInterfaceChange	Registriert den Treiber, der bei Änderungen an allen IP-Schnittstellen, IPv4-Schnittstellen oder IPv6-Schnittstellen auf einem lokalen Computer benachrichtigt werden soll.
NotifyRouteChange2	Registriert sich, um bei Änderungen an IP-Routeneinträgen auf einem lokalen Computer benachrichtigt zu werden.
NotifyUnicastIpAddressChange	Registriert sich für Ä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 sich, um für Änderungen an der UDP-Portnummer benachrichtigt zu werden, die der Teredo-Client für den Teredo-Dienstport 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 Netzwerkschnittstellenstapel. 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 der Netzwerkschnittstelle. Diese Tabelle gibt die Beziehung der Netzwerkschnittstellen auf einem Schnittstellenstapel in umgekehrter Reihenfolge an.
MIB_IPFORWARD_ROW2	Speichert Informationen zu einem IP-Routeneintrag.
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 zu einem IP-Pfadeintrag.
MIB_IPPATH_TABLE	Enthält eine Tabelle mit IP-Pfadeinträgen.
MIB_MULTICASTIPADDRESS_ROW	Speichert Informationen zu einer 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-Enumerationen

Enumeration	Beschreibung
MIB_IF_TABLE_LEVEL	Definiert die Ebene der abzurufenden Schnittstelleninformationen.
MIB_NOTIFICATION_TYPE	Definiert den Benachrichtigungstyp, der an eine Rückruffunktion übergeben wird, wenn eine Benachrichtigung auftritt.

NL-Enumerationen

Enumeration	Beschreibung
NL_ADDRESS_TYPE	Gibt den IP-Adresstyp der Netzwerkebene an.
NL_DAD_STATE	Definiert den DAD-Zustand (Duplicate Address Detection).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR	Definiert das Verhalten der lokalen Linkadresse.
NL_NEIGHBOR_STATE	Definiert den Status einer IP-Adresse der Netzwerkebene, 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 Routerermittlungsverhalten, wie in RFC 2461 beschrieben.
NL_SUFFIX_ORIGIN	Definiert den Ursprung des Suffixes oder des Hostteils der IP-Adresse.