Übersicht über DAS IP-Hilfsprogramm

Mit dem Internetprotokollhilfsprogramm (IP-Hilfsprogramm) können Treiber Informationen zur Netzwerkkonfiguration des lokalen Computers abrufen und diese Konfiguration ändern. DAS IP-Hilfsprogramm stellt auch Benachrichtigungsmechanismen bereit, um sicherzustellen, dass ein Treiber benachrichtigt wird, wenn sich bestimmte Aspekte der Netzwerkkonfiguration des lokalen Computers ändern. DAS IP-Hilfsprogramm ist in Windows Vista und höheren Versionen der Microsoft Windows-Betriebssysteme 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.

In der Dokumentation zum IP-Hilfsprogramm werden die Begriffe "Adapter" und "Schnittstelle" häufig verwendet. Ein Adapter ist ein Legacybegriff, der eine abgekürzte Form des Netzwerkadapters ist, die sich ursprünglich auf eine Form von Netzwerkhardware bezog. Ein Adapter ist eine Abstraktion auf Datenlinkebene.

Eine Schnittstelle wird in den IETF RFC-Dokumenten als abstraktes Konzept beschrieben, das die Anlage eines Knotens an einen 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 TCP/IP-Transporte (Transmission Control Protocol/Internet Protocol) auf einem lokalen Computer abzurufen und zu ändern.

Hinweis

 Befolgen Sie beim Entwickeln von Treibercode die Anweisungen zum Einschließen von Headerdateien.

Schnittstellenkonvertierungsfunktionen

Funktion BESCHREIBUNG

ConvertInterfaceAliasToLuid

Konvertiert einen lokal eindeutigen Bezeichner (LUID) für eine Netzwerkschnittstelle in den Namen der Unicode-Schnittstelle.

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 NAMEN der ANSI-Schnittstelle.

ConvertInterfaceLuidToNameW

Konvertiert eine LUID für eine Netzwerkschnittstelle in den Namen der Unicode-Schnittstelle.

ConvertInterfaceNameToLuidA

Konvertiert einen ANSI-Netzwerkschnittstellennamen in die LUID für die Schnittstelle.

ConvertInterfaceNameToLuidW

Konvertiert einen Namen der Unicode-Netzwerkschnittstelle in die LUID für die Schnittstelle.

if_indextoname

Konvertiert den lokalen Index für eine Netzwerkschnittstelle in den Namen der ANSI-Schnittstelle.

if_nametoindex

Konvertiert den Namen der ANSI-Schnittstelle 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 Zeileneinträgen des Netzwerkschnittstellenstapels ab, die die Beziehung der Netzwerkschnittstellen auf einem Schnittstellenstapel angeben.

GetIfTable2

Ruft die MIB-II-Schnittstellentabelle ab.

GetIfTable2Ex

Ruft die MIB-II-Schnittstellentabelle ab, wenn eine Ebene der abzurufenden Schnittstelleninformationen angegeben ist.

GetInvertedIfStackTable

Ruft eine Tabelle mit invertierten Zeileneinträgen des Netzwerkschnittstellenstapels ab, die die Beziehung der Netzwerkschnittstellen auf 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-Adressverwaltung-Funktionen

Funktion BESCHREIBUNG

CreateAnycastIpAddressEntry

Fügt einen neuen Anycast-IP-Adresseintrag auf dem lokalen Computer hinzu.

CreateSortedAddressPairs

Koppelt eine angegebene Liste von Zieladressen 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.

IP-Nachbar-Adressverwaltungsfunktionen

Funktion BESCHREIBUNG

CreateIpNetEntry2

Erstellt einen neuen Ip-Adresseintrag für nachbarn auf dem lokalen Computer.

DeleteIpNetEntry2

Löscht einen Nachbar-IP-Adresseintrag vom lokalen Computer.

FlushIpNetTable2

Leert die IP-Nachbartabelle auf dem lokalen Computer.

GetIpNetEntry2

Ruft Informationen für einen Nachbar-IP-Adresseintrag 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-Nachbaradresseneintrag auf dem lokalen Computer auf.

SetIpNetEntry2

Legt die physische Adresse eines vorhandenen IP-Nachbaradresseneintrags auf dem lokalen Computer fest.

IP-Pfadverwaltungsfunktionen

Funktion BESCHREIBUNG

FlushIpPathTable

Leert 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 für die beste Route zur angegebenen Ziel-IP-Adresse ab.

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.

Speicherverwaltungsfunktionen für IP-Tabellen

Funktion BESCHREIBUNG

FreeMibTable

Gibt den Puffer frei, der von den Funktionen zugeordnet wird, die Tabellen von 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-Adressänderungen, IP-Routenänderungen und Anforderungen zum Abrufen der stabilen Unicast-IP-Adresstabelle auf.

NotifyIpInterfaceChange

Registriert den Treiber, der über Änderungen an allen IP-Schnittstellen, IPv4-Schnittstellen oder IPv6-Schnittstellen auf einem lokalen Computer benachrichtigt wird.

NotifyRouteChange2

Registriert, um über Änderungen an IP-Routeneinträgen auf einem lokalen Computer benachrichtigt zu werden.

NotifyUnicastIpAddressChange

Registriert, um über Änderungen an allen Unicast-IP-Schnittstellen, Unicast-IPv4-Adressen oder Unicast-IPv6-Adressen auf einem lokalen Computer benachrichtigt zu werden.

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 über Ä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. In dieser Tabelle wird die Beziehung der Netzwerkschnittstellen in einem Schnittstellenstapel angegeben.

MIB_INVERTEDIFSTACK_ROW

Stellt die Beziehung zwischen zwei Netzwerkschnittstellen dar.

MIB_INVERTEDIFSTACK_TABLE

Enthält eine Tabelle mit invertierten Zeileneinträgen des Netzwerkschnittstellenstapels. In dieser Tabelle wird die Beziehung der Netzwerkschnittstellen zu einem Schnittstellenstapel in umgekehrter Reihenfolge angegeben.

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 benachbarten IP-Adresseinträgen.

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 bei einer Benachrichtigung an eine Rückruffunktion übergeben wird.

NL-Enumerationen

Enumeration Beschreibung

NL_ADDRESS_TYPE

Gibt den IP-Adresstyp der Netzwerkschicht an.

NL_DAD_STATE

Definiert den DaD-Zustand (Duplicate Address Detection).

NL_LINK_LOCAL_ADDRESS_BEHAVIOR

Definiert das Lokale Adressverhalten der Verknüpfung.

NL_NEIGHBOR_STATE

Definiert den Zustand einer benachbarten IP-Adresse auf Netzwerkebene, wie in RFC 2461, Abschnitt 7.3.2 beschrieben.

NL_PREFIX_ORIGIN

Definiert den Ursprung des Präfixes oder Des 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 der Routerermittlung, wie in RFC 2461 beschrieben.

NL_SUFFIX_ORIGIN

Definiert den Ursprung des Suffixs oder Hostteils der IP-Adresse.