InitializeUnicastIpAddressEntry, fonction
La fonction InitializeUnicastIpAddressEnt ry initialise une structure MIB_UNICASTIPADDRESS_ROW avec des valeurs par défaut pour une entrée d’adresse IP unidiffusion sur un ordinateur local.
Syntaxe
VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
_Out_ PMIB_UNICASTIPADDRESS_ROW Row
);
Paramètres
-
ligne [out]
Lors de l’entrée, un pointeur vers une entrée de structure MIB_UNICASTIPADDRESS_ROW pour une entrée d’adresse IP monodiffusion. Lors du retour, la structure MIB_UNICASTIPADDRESS_ROW à laquelle ce paramètre pointe est initialisée avec des valeurs par défaut pour une adresse IP de monodiffusion.
Valeur de retour
Aucun
Remarques
Votre pilote doit utiliser la fonction InitializeUnicastIpAddressEntry pour initialiser les membres d’une entrée de structure MIB_UNICASTIPADDRESS_ROW avec des valeurs par défaut pour une adresse IP unidiffusion pour une utilisation ultérieure avec la fonction CreateUnicastIpAddressEntry.
Lors de l’entrée, votre pilote doit passer InitializeUnicastIpAddressEntry une nouvelle structure de MIB_UNICASTIPADDRESS_ROW à initialiser.
Lors de la sortie, les membres de la structure MIB_UNICASTIPADDRESS_ROW que le paramètre Ligne à initialiser comme suit.
PrefixOrigin
Défini sur la valeur IpPrefixOriginUnchanged de l’énumération NL_PREFIX_ORIGIN.SuffixeOrigin
Défini sur la valeur IpSuffixOriginUnchanged de l’énumération NL_PREFIX_ORIGIN.OnLinkPrefixLength
Défini sur une valeur non valide.PreferredLifetime et ValidLifetime
Défini sur des valeurs infinies.skipAsSource
Défini sur false.Tous les autres membres
Défini sur zéro.
Une fois qu’un pilote appelle InitializeUnicastIpAddressEntry, le pilote peut ensuite modifier les membres de l’entrée MIB_UNICASTIPADDRESS_ROW qu’il souhaite modifier, puis appeler l'CreateUnicastIpAddressEntry pour ajouter la nouvelle adresse IP unidiffusion à l’ordinateur local.