Fonction InitializeUnicastIpAddressEntry (netioapi.h)

Article
02/29/2024

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