Fonction InitializeUnicastIpAddressEntry (netioapi.h)
La fonction InitializeUnicastIpAddressEntry initialise une structure MIB_UNICASTIPADDRESS_ROW avec les valeurs par défaut d’une entrée d’adresse IP de monodiffusion sur l’ordinateur local.
Syntaxe
IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
[out] PMIB_UNICASTIPADDRESS_ROW Row
);
Paramètres
[out] Row
Lors de l’entrée, un pointeur vers une MIB_UNICASTIPADDRESS_ROW entrée de structure pour une entrée d’adresse IP de monodiffusion. Au retour, la structure MIB_UNICASTIPADDRESS_ROW pointée par ce paramètre est initialisée avec les valeurs par défaut d’une adresse IP de monodiffusion.
Valeur renvoyée
Cette fonction ne retourne pas de valeur.
Notes
La fonction InitializeUnicastIpAddressEntry est définie sur Windows Vista et versions ultérieures.
La fonction InitializeUnicastIpAddressEntry doit être utilisée pour initialiser les membres d’une entrée de structure MIB_UNICASTIPADDRESS_ROW avec les valeurs par défaut d’une adresse IP de monodiffusion en vue d’une utilisation ultérieure avec la fonction CreateUnicastIpAddressEntry .
Lors de l’entrée, InitializeUnicastIpAddressEntry doit être passé une nouvelle structure MIB_UNICASTIPADDRESS_ROW à initialiser.
Lors de la sortie, le membre PrefixOrigin de la structure MIB_UNICASTIPADDRESS_ROW pointée vers le paramètre Row est initialisé à IpPrefixOriginUnchanged, le membre SuffixOrigin Est initialisé à IpSuffixOriginUnchanged et le membre OnLinkPrefixLength est initialisé à une valeur non conforme. En outre, les membres PreferredLifetime et ValidLifetime sont définis sur infini, le membre SkipAsSource est défini sur FALSE et les autres champs sont initialisés à zéro.
Après avoir appelé InitializeUnicastIpAddressEntry, une application peut modifier les membres de l’entrée MIB_UNICASTIPADDRESS_ROW qu’elle souhaite modifier, puis appeler CreateUnicastIpAddressEntry pour ajouter la nouvelle adresse IP de monodiffusion à 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 (include Iphlpapi.h) |
| Bibliothèque | Iphlpapi.lib |
| DLL | Iphlpapi.dll |