InitializeUnicastIpAddressEntry, functie

Artikel
2025-03-13

De functie InitializeUnicastIpAddressEntry initialiseert een MIB_UNICASTIPADDRESS_ROW structuur met standaardwaarden voor een unicast-IP-adresvermelding op een lokale computer.

Syntaxis

VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  _Out_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parameters

rij [uit]
Bij invoer verwijst een aanwijzer naar een MIB_UNICASTIPADDRESS_ROW structuurvermelding voor een unicast-IP-adresvermelding. Bij retour wordt de MIB_UNICASTIPADDRESS_ROW structuur waarnaar deze parameter verwijst geïnitialiseerd met standaardwaarden voor een unicast-IP-adres.

Retourwaarde

Geen

Opmerkingen

Uw stuurprogramma moet de functie InitializeUnicastIpAddressEntry gebruiken om de leden van een MIB_UNICASTIPADDRESS_ROW structuurvermelding te initialiseren met standaardwaarden voor een unicast-IP-adres voor later gebruik met de CreateUnicastIpAddressEntry- functie.

Bij invoer moet uw stuurprogramma InitializeUnicastIpAddressEntry een nieuwe MIB_UNICASTIPADDRESS_ROW structuur doorgeven om te initialiseren.

Bij uitvoer worden de leden van de MIB_UNICASTIPADDRESS_ROW structuur waarnaar de rij- parameter verwijst als volgt geïnitialiseerd.

PrefixOrigin-
Ingesteld op de IpPrefixOriginUnchanged waarde van de opsomming NL_PREFIX_ORIGIN.
SuffixOrigin-
Ingesteld op de IpSuffixOriginUnchanged waarde van de opsomming NL_PREFIX_ORIGIN.
OnLinkPrefixLength-
Ingesteld op een ongeldige waarde.
PreferredLifetime- en ValidLifetime-
Ingesteld op oneindige waarden.
SkipAsSource-
Ingesteld op ONWAAR.
Alle andere leden
Ingesteld op nul.

Nadat een stuurprogramma InitializeUnicastIpAddressEntry-aanroept, kan het stuurprogramma vervolgens de leden in de MIB_UNICASTIPADDRESS_ROW vermelding wijzigen die het wil wijzigen en vervolgens de CreateUnicastIpAddressEntry- aanroepen om het nieuwe unicast-IP-adres toe te voegen aan de lokale computer.

Eisen

Doelplatform	Universal
Versie	Beschikbaar in Windows Vista en latere versies van de Windows-besturingssystemen.
Rubriek	Netioapi.h (inclusief Netioapi.h)
Bibliotheek	Netio.lib
IRQL	< DISPATCH_LEVEL