Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |