Vue d’ensemble de l’assistance IP

Article
07/08/2024

Internet Protocol Helper (IP Helper) permet aux pilotes de récupérer des informations sur la configuration réseau de l’ordinateur local et de modifier cette configuration. L’assistance IP fournit également des mécanismes de notification pour s’assurer qu’un pilote est averti lorsque certains aspects de la configuration du réseau de l’ordinateur local changent. L’assistance IP est disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Microsoft Windows.

La plupart des fonctions d’assistance IP passent des paramètres de structure qui représentent des types de données associés à la technologie MIB (Management Information Base). Les fonctions d’assistance IP utilisent ces structures MIB pour représenter diverses informations réseau.

La documentation de l’assistance IP utilise largement les termes « adaptateur » et « interface ». Une carte est un terme hérité qui est une forme abrégée de carte réseau, qui a initialement fait référence à une forme de matériel réseau. Un adaptateur est une abstraction au niveau des liens de données.

Une interface est décrite dans les documents RFC IETF en tant que concept abstrait qui représente la pièce jointe d’un nœud à un lien. Une interface est une abstraction au niveau IP.

Votre pilote peut utiliser les fonctions en mode noyau, les structures MIB et les énumérations MIB et NL (Network Layer) suivantes pour récupérer et modifier les paramètres de configuration pour le transport TCP/IP (Transmission Control Protocol) sur un ordinateur local.

Remarque

Lorsque vous développez du code de pilote, suivez les instructions pour inclure des fichiers d’en-tête.

Fonctions de conversion d'interface

Fonction	Description
ConvertInterfaceAliasToLuid	Convertit un identificateur unique localement (LUID) pour une interface réseau en nom d’interface Unicode.
ConvertInterfaceGuidToLuid	Convertit un identificateur global unique (GUID) pour une interface réseau en LUID pour l’interface.
ConvertInterfaceIndexToLuid	Convertit un index local pour une interface réseau en LUID pour l’interface.
ConvertInterfaceLuidToAlias	Convertit un LUID pour une interface réseau en alias d’interface.
ConvertInterfaceLuidToGuid	Convertit un LUID pour une interface réseau en GUID pour l’interface.
ConvertInterfaceLuidToIndex	Convertit un LUID pour une interface réseau en index local de l’interface.
ConvertInterfaceLuidToNameA	Convertit un LUID pour une interface réseau en nom d’interface ANSI.
ConvertInterfaceLuidToNameW	Convertit un LUID pour une interface réseau en nom d’interface Unicode.
ConvertInterfaceNameToLuidA	Convertit un nom d’interface réseau ANSI en LUID pour l’interface.
ConvertInterfaceNameToLuidW	Convertit un nom d’interface réseau Unicode en LUID pour l’interface.
if_indextoname	Convertit l’index local d’une interface réseau en nom d’interface ANSI.
if_nametoindex	Convertit le nom de l’interface ANSI d’une interface réseau en index local de l’interface.

Fonctions de gestion d'interface

Fonction	Description
GetIfEntry2	Récupère des informations pour l’interface spécifiée sur l’ordinateur local.
GetIfStackTable	Récupère une table des entrées de ligne de pile d’interface réseau qui spécifient la relation des interfaces réseau sur une pile d’interfaces.
GetIfTable2	Récupère la table d’interface MIB-II.
GetIfTable2Ex	Récupère la table d’interface MIB-II, en fonction d’un niveau d’informations d’interface à récupérer.
GetInvertedIfStackTable	Récupère une table des entrées de ligne de pile d’interface réseau inversées qui spécifient la relation des interfaces réseau sur une pile d’interface.
GetIpInterfaceEntry	Récupère les informations IP de l’interface spécifiée sur l’ordinateur local.
GetIpInterfaceTable	Récupère les entrées d’interface IP sur l’ordinateur local.
InitializeIpInterfaceEntry	Initialise les membres d’une entrée de structure MIB_IPINTERFACE_ROW avec des valeurs par défaut.
SetIpInterfaceEntry	Définit les propriétés d’une interface IP sur l’ordinateur local.

Fonctions de gestion d'adresse IP

Fonction	Description
CreateAnycastIpAddressEntry	Ajoute une nouvelle entrée d’adresse IP anycast sur l’ordinateur local.
CreateSortedAddressPairs	Associe une liste fournie d’adresses de destination avec les adresses IP locales de l’ordinateur hôte et trie les paires en fonction de l’ordre de communication préféré.
CreateUnicastIpAddressEntry	Ajoute une nouvelle entrée d’adresse IP monodiffusion sur l’ordinateur local.
DeleteAnycastIpAddressEntry	Supprime une entrée d’adresse IP anycast existante sur l’ordinateur local.
DeleteUnicastIpAddressEntry	Supprime une entrée d’adresse IP monodiffusion existante de l’ordinateur local.
GetAnycastIpAddressEntry	Récupère des informations pour une entrée d’adresse IP anycast existante sur l’ordinateur local.
GetAnycastIpAddressTable	Récupère la table d’adresses IP anycast sur l’ordinateur local.
GetMulticastIpAddressEntry	Récupère des informations pour une entrée d’adresse IP de multidiffusion existante sur l’ordinateur local.
GetMulticastIpAddressTable	Récupère la table d’adresses IP de multidiffusion sur l’ordinateur local.
GetUnicastIpAddressEntry	Récupère des informations pour une entrée d’adresse IP de monodiffusion existante sur l’ordinateur local.
GetUnicastIpAddressTable	Récupère la table d’adresses IP de monodiffusion sur l’ordinateur local.
InitializeUnicastIpAddressEntry	Initialise une structure MIB_UNICASTIPADDRESS_ROW avec des valeurs par défaut pour une entrée d’adresse IP monodiffusion sur l’ordinateur local.
NotifyStableUnicastIpAddressTable	Récupère la table d’adresses IP unidiffusion stable sur un ordinateur local.
SetUnicastIpAddressEntry	Définit les propriétés d’une entrée d’adresse IP monodiffusion existante sur l’ordinateur local.

Fonctions de gestion d'adresse de voisin IP

Fonction	Description
CreateIpNetEntry2	Crée une entrée d’adresse IP voisine sur l’ordinateur local.
DeleteIpNetEntry2	Supprime une entrée d’adresse IP voisine de l’ordinateur local.
FlushIpNetTable2	Vide la table voisin IP sur l’ordinateur local.
GetIpNetEntry2	Récupère des informations pour une entrée d’adresse IP voisine sur l’ordinateur local.
GetIpNetTable2	Récupère la table voisin IP sur l’ordinateur local.
ResolveIpNetEntry2	Résout l’adresse physique d’une entrée d’adresse IP voisine sur l’ordinateur local.
SetIpNetEntry2	Définit l’adresse physique d’une entrée d’adresse IP voisine existante sur l’ordinateur local.

Fonctions de gestion de chemin d’accès IP

Fonction	Description
FlushIpPathTable	Vide la table de chemins d’accès IP sur l’ordinateur local.
GetIpPathEntry	Récupère des informations pour une entrée de chemin d’accès IP sur l’ordinateur local.
GetIpPathTable	Récupère des informations pour une entrée de chemin d’accès IP sur l’ordinateur local.

Fonctions de gestion d'itinéraire IP

Fonction	Description
CreateIpForwardEntry2	Crée une entrée d’itinéraire IP sur l’ordinateur local.
DeleteIpForwardEntry2	Supprime une entrée d’itinéraire IP de l’ordinateur local.
GetBestRoute2	Récupère l’entrée d’itinéraire IP sur l’ordinateur local pour le meilleur itinéraire vers l’adresse IP de destination spécifiée.
GetIpForwardEntry2	Récupère des informations pour une entrée d’itinéraire IP sur l’ordinateur local.
GetIpForwardTable2	Récupère les entrées d’itinéraire IP sur l’ordinateur local.
InitializeIpForwardEntry	Initialise une structure MIB_IPFORWARD_ROW2 avec des valeurs par défaut pour une entrée d’itinéraire IP sur l’ordinateur local.
SetIpForwardEntry2	Définit les propriétés d’une entrée d’itinéraire IP sur l’ordinateur local.

Fonctions de gestion de mémoire de table IP

Fonction	Description
FreeMibTable	Libère la mémoire tampon allouée par les fonctions qui retournent des tables d’interfaces réseau, d’adresses et d’itinéraires (par exemple, GetIfTable2 et GetAnycastIpAddressTable).

Fonctions de notification

Fonction	Description
CancelMibChangeNotify2	Annule l’inscription du pilote pour les notifications de modification pour les modifications d’interface IP, les modifications d’adresse IP, les modifications d’itinéraire IP et les demandes de récupération de la table d’adresses IP unidiffusion stable.
NotifyIpInterfaceChange	Inscrit le pilote pour être informé des modifications apportées à toutes les interfaces IP, interfaces IPv4 ou interfaces IPv6 sur un ordinateur local.
NotifyRouteChange2	S’inscrit pour être averti des modifications apportées aux entrées d’itinéraire IP sur un ordinateur local.
NotifyUnicastIpAddressChange	S’inscrit pour être informé des modifications apportées à toutes les interfaces IP unidiffusion, adresses IPv4 unidiffusion ou adresses IPv6 unidiffusion sur un ordinateur local.

Fonctions de gestion de client IPv6 Teredo

Fonction	Description
GetTeredoPort	Récupère le numéro de port UDP dynamique utilisé par le client Teredo sur l’ordinateur local.
NotifyTeredoPortChange	S’inscrit à être informé des modifications apportées au numéro de port UDP que le client Teredo utilise pour le port du service Teredo sur un ordinateur local.
NotifyStableUnicastIpAddressTable	Récupère la table d’adresses IP unidiffusion stable sur un ordinateur local.

Structures MIB

Structure	Description
IP_ADDRESS_PREFIX	Stocke un préfixe d’adresse IP.
MIB_ANYCASTIPADDRESS_ROW	Stocke des informations sur une adresse IP anycast.
MIB_ANYCASTIPADDRESS_TABLE	Contient une table des entrées d’adresse IP anycast.
MIB_IF_ROW2	Stocke des informations sur une interface particulière.
MIB_IF_TABLE2	Contient une table des entrées d’interface logique et physique.
MIB_IFSTACK_ROW	Représente la relation entre deux interfaces réseau.
MIB_IFSTACK_TABLE	Contient une table des entrées de ligne dans la pile d’interface réseau. Ce tableau spécifie la relation des interfaces réseau sur une pile d’interfaces.
MIB_INVERTEDIFSTACK_ROW	Représente la relation entre deux interfaces réseau.
MIB_INVERTEDIFSTACK_TABLE	Contient une table des entrées de ligne de pile d’interface réseau inversée. Ce tableau spécifie la relation des interfaces réseau sur une pile d’interfaces dans l’ordre inverse.
MIB_IPFORWARD_ROW2	Stocke des informations sur une entrée d’itinéraire IP.
MIB_IPFORWARD_TABLE2	Contient une table des entrées d’itinéraire IP.
MIB_IPINTERFACE_ROW	Stocke les informations de gestion des interfaces pour une famille d’adresses IP particulière sur une interface réseau.
MIB_IPINTERFACE_TABLE	Contient une table des entrées d’interface IP.
MIB_IPNET_ROW2	Stocke des informations sur une adresse IP voisine.
MIB_IPNET_TABLE2	Contient une table des entrées d’adresse IP voisines.
MIB_IPPATH_ROW	Stocke des informations sur une entrée de chemin d’accès IP.
MIB_IPPATH_TABLE	Contient une table des entrées de chemin d’accès IP.
MIB_MULTICASTIPADDRESS_ROW	Stocke des informations sur une adresse IP de multidiffusion.
MIB_MULTICASTIPADDRESS_TABLE	Contient une table des entrées d’adresse IP de multidiffusion.
MIB_UNICASTIPADDRESS_ROW	Stocke des informations sur une adresse IP monodiffusion.
MIB_UNICASTIPADDRESS_TABLE	Contient une table des entrées d’adresse IP unidiffusion.

Énumérations MIB

Énumération	Description
MIB_IF_TABLE_LEVEL	Définit le niveau d’informations d’interface à récupérer.
MIB_NOTIFICATION_TYPE	Définit le type de notification passé à une fonction de rappel lorsqu’une notification se produit.

Énumérations NL

Énumération	Description
NL_ADDRESS_TYPE	Spécifie le type d’adresse IP de la couche réseau.
NL_DAD_STATE	Définit l’état de détection d’adresses en double (DAD).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR	Définit le comportement d’adresse locale du lien.
NL_NEIGHBOR_STATE	Définit l’état d’une adresse IP voisine de couche réseau, comme décrit dans RFC 2461, section 7.3.2.
NL_PREFIX_ORIGIN	Définit l’origine du préfixe ou de la partie réseau de l’adresse IP.
NL_ROUTE_ORIGIN	Définit l’origine de l’itinéraire IP.
NL_ROUTE_PROTOCOL	Définit le mécanisme de routage avec lequel un itinéraire IP a été ajouté, comme décrit dans RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR	Définit le comportement de découverte du routeur, comme décrit dans RFC 2461.
NL_SUFFIX_ORIGIN	Définit l’origine du suffixe ou de la partie hôte de l’adresse IP.

Partager via