Fonction InitializeIpForwardEntry (netioapi.h)

Article
02/29/2024

La fonction InitializeIpForwardEntry initialise une structure MIB_IPFORWARD_ROW2 avec les valeurs par défaut pour une entrée de route IP sur l’ordinateur local.

Syntaxe

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

Paramètres

[out] Row

Lors de l’entrée, un pointeur vers une MIB_IPFORWARD_ROW2 entrée de structure pour une entrée de route IP. Au retour, la structure MIB_IPFORWARD_ROW2 pointée vers ce paramètre est initialisée avec les valeurs par défaut pour une entrée de route IP.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

La fonction InitializeIpForwardEntry est définie sur Windows Vista et versions ultérieures.

La fonction InitializeIpForwardEntry doit être utilisée 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 pour une utilisation ultérieure avec la fonction CreateIpForwardEntry2 .

En entrée, InitializeIpForwardEntry doit être passé une nouvelle structure MIB_IPFORWARD_ROW2 pour initialiser.

À la sortie, les membres ValidLifetime et PreferredLifetime de la structure MIB_IPFORWARD_ROW2 pointées par le paramètre Row seront initialisés à l’infini et les membres Loopback, AutoconfigureAddress, Publish et Immortal seront initialisés sur TRUE. En outre, les membres SitePrefixLength, Metric et Protocol sont définis sur une valeur non valide et d’autres champs sont initialisés à zéro.

Après avoir appelé InitializeIpForwardEntry, une application peut modifier les membres de l’entrée MIB_IPFORWARD_ROW2 qu’elle souhaite modifier, puis appeler CreateIpForwardEntry2 pour ajouter la nouvelle entrée de route IP à l’ordinateur local.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netioapi.h (inclure Iphlpapi.h)
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll