Fonction InitializeUnicastIpAddressEntry

Article
03/08/2023

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 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 MIB_UNICASTIPADDRESS_ROW entrée de structure pour une entrée d’adresse IP de monodiffusion. Au retour, la structure MIB_UNICASTIPADDRESS_ROW vers laquelle ce paramètre pointe est initialisée avec les valeurs par défaut d’une adresse IP de monodiffusion.

Valeur de retour

None

Notes

Votre pilote doit utiliser la fonction InitializeUnicastIpAddressEntry 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 pour une utilisation ultérieure avec la fonction CreateUnicastIpAddressEntry .

Lors de l’entrée, votre pilote doit passer InitializeUnicastIpAddressEntry une nouvelle structure MIB_UNICASTIPADDRESS_ROW à initialiser.

Lors de la sortie, les membres de la structure MIB_UNICASTIPADDRESS_ROW vers laquelle pointe le paramètre Row sont initialisés comme suit.

PrefixOrigin
Définissez sur la valeur IpPrefixOriginUnchanged de l’énumération NL_PREFIX_ORIGIN .
SuffixeOrigin
Définissez sur la valeur IpSuffixOriginUnchanged de l’énumération NL_PREFIX_ORIGIN .
OnLinkPrefixLength
Définissez sur une valeur non conforme.
PreferredLifetime et ValidLifetime
Définissez sur des valeurs infinies.
SkipAsSource
Définissez sur FALSE.
Tous les autres membres
Définit la valeur zéro.

Après qu’un pilote a appelé InitializeUnicastIpAddressEntry, il peut modifier les membres de l’entrée MIB_UNICASTIPADDRESS_ROW qu’il souhaite modifier, puis appeler CreateUnicastIpAddressEntry pour ajouter la nouvelle adresse IP de monodiffusion à l’ordinateur local.

Spécifications

Plateforme cible	Universal
Version	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
En-tête	Netioapi.h (inclure Netioapi.h)
Bibliothèque	Netio.lib
IRQL	< DISPATCH_LEVEL