InitializeUnicastIpAddressEntry-Funktion (netioapi.h)

Artikel
03/04/2024

Die InitializeUnicastIpAddressEntry-Funktion initialisiert eine MIB_UNICASTIPADDRESS_ROW-Struktur mit Standardwerten für einen Unicast-IP-Adresseintrag auf dem lokalen Computer.

Syntax

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeUnicastIpAddressEntry(
  [out] PMIB_UNICASTIPADDRESS_ROW Row
);

Parameter

[out] Row

Beim Eintrag ein Zeiger auf einen MIB_UNICASTIPADDRESS_ROW-Struktureintrag für einen Unicast-IP-Adresseintrag. Bei der Rückgabe wird die MIB_UNICASTIPADDRESS_ROW Struktur, auf die dieser Parameter verweist, mit Standardwerten für eine Unicast-IP-Adresse initialisiert.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

Die InitializeUnicastIpAddressEntry-Funktion ist unter Windows Vista und höher definiert.

Die InitializeUnicastIpAddressEntry-Funktion muss verwendet werden, um die Member eines MIB_UNICASTIPADDRESS_ROW-Struktureintrags mit Standardwerten für eine Unicast-IP-Adresse zur späteren Verwendung mit der CreateUnicastIpAddressEntry-Funktion zu initialisieren.

Bei der Eingabe muss InitializeUnicastIpAddressEntry eine neue MIB_UNICASTIPADDRESS_ROW-Struktur übergeben werden, um zu initialisieren.

Bei der Ausgabe wird das PrefixOrigin-Element der MIB_UNICASTIPADDRESS_ROW Struktur, auf die der Row-Parameter verweist, in IpPrefixOriginUnchanged initialisiert, das SuffixOrigin-Element wird in IpSuffixOriginUnchanged initialisiert, und das OnLinkPrefixLength-Element wird mit einem unzulässigen Wert initialisiert. Darüber hinaus sind die Elemente PreferredLifetime und ValidLifetime auf unendlich, das SkipAsSource-Element auf FALSE festgelegt, und andere Felder werden auf 0 (null) initialisiert.

Nach dem Aufrufen von InitializeUnicastIpAddressEntry kann eine Anwendung dann die Member im MIB_UNICASTIPADDRESS_ROW Eintrag ändern, den sie ändern möchte, und dann CreateUnicastIpAddressEntry aufrufen, um die neue Unicast-IP-Adresse dem lokalen Computer hinzuzufügen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netioapi.h (include Iphlpapi.h)
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll