InitializeUnicastIpAddressEntry-Funktion (netioapi.h)
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 |