Fonction InitializeIpForwardEntry (netioapi.h)
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 |