Partager via


InitializeIpForwardEntry, fonction

La fonction InitializeIpForwardEnt ry initialise une structure MIB_IPFORWARD_ROW2 avec des valeurs par défaut pour 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 entrée de structure MIB_IPFORWARD_ROW2 pour une entrée d’itinéraire IP.

    Lors du retour, la structure MIB_IPFORWARD_ROW2 à laquelle ce paramètre pointe est initialisée avec des valeurs par défaut pour une entrée d’itinéraire IP.

Valeur de retour

Aucun

Remarques

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

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

Lors de la sortie, les membres de la structure MIB_IPFORWARD_ROW2 que le paramètre Row à initialiser comme suit.

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

  • de bouclage, AutoconfigureAddress, Publieret Immortal
    Défini sur TRUE.

  • SitePrefixLength, metricet Protocol
    Défini sur des valeurs non valides.

  • Tous les autres membres
    Défini sur zéro.

Une fois qu’un pilote appelle InitializeIpForwardEntry, le pilote peut ensuite modifier les membres de l’entrée MIB_IPFORWARD_ROW2 qu’il souhaite modifier, puis appeler l'CreateIpForwardEntry2 pour ajouter la nouvelle entrée d’itinéraire IP à l’ordinateur local.

Exigences

Plateforme cible

universel

Version

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

En-tête

Netioapi.h (include Netioapi.h)

Bibliothèque

Netio.lib

IRQL

< DISPATCH_LEVEL

Voir aussi

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2