Partager via


Fonction InitializeIpForwardEntry

La fonction InitializeIpForwardEntry initialise une structure MIB_IPFORWARD_ROW2 avec les valeurs par défaut d’une entrée d’itinéraire IP sur un ordinateur local.

Syntaxe

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Paramètres

  • Ligne [out]
    Lors de l’entrée, un pointeur vers une MIB_IPFORWARD_ROW2 entrée de structure pour une entrée d’itinéraire IP.

    Au retour, la structure MIB_IPFORWARD_ROW2 vers laquelle ce paramètre pointe est initialisée avec les valeurs par défaut d’une entrée d’itinéraire IP.

Valeur de retour

None

Notes

Votre pilote doit utiliser la fonction InitializeIpForwardEntry pour initialiser les membres d’une entrée de structure MIB_IPFORWARD_ROW2 avec les valeurs par défaut d’une entrée de route IP en vue d’une utilisation ultérieure avec la fonction CreateIpForwardEntry2 .

Lors de l’entrée, votre pilote doit passer InitializeIpForwardEntry une nouvelle structure MIB_IPFORWARD_ROW2 à initialiser.

Lors de la sortie, les membres de la structure MIB_IPFORWARD_ROW2 vers laquelle pointe le paramètre Row sont initialisés comme suit.

  • ValidLifetime et PreferredLifetime
    Défini sur une valeur infinie,

  • Bouclage, AutoconfigureAddress, Publish et Immortal
    Définissez sur TRUE.

  • SitePrefixLength, Metric et Protocol
    Définissez sur des valeurs non conformes.

  • Tous les autres membres
    Définit la valeur zéro.

Après qu’un pilote a appelé InitializeIpForwardEntry, le pilote peut modifier les membres de l’entrée MIB_IPFORWARD_ROW2 qu’il souhaite modifier, puis appeler CreateIpForwardEntry2 pour ajouter la nouvelle entrée d’itinéraire IP à l’ordinateur local.

Spécifications

Plateforme cible

Universal

Version

Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.

En-tête

Netioapi.h (inclure Netioapi.h)

Bibliothèque

Netio.lib

IRQL

< DISPATCH_LEVEL

Voir aussi

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2