InitializeIpForwardEntry-Funktion (netioapi.h)

Artikel
03/04/2024

Die InitializeIpForwardEntry-Funktion initialisiert eine MIB_IPFORWARD_ROW2-Struktur mit Standardwerten für einen IP-Routeneintrag auf dem lokalen Computer.

Syntax

IPHLPAPI_DLL_LINKAGE VOID NETIOAPI_API_ InitializeIpForwardEntry(
  [out] PMIB_IPFORWARD_ROW2 Row
);

Parameter

[out] Row

Beim Einstieg zeigt ein Zeiger auf einen MIB_IPFORWARD_ROW2 Struktureintrag für einen IP-Routeneintrag. Bei der Rückgabe wird die MIB_IPFORWARD_ROW2 Struktur, auf die dieser Parameter verweist, mit Standardwerten für einen IP-Routeneintrag initialisiert.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Bemerkungen

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

Die InitializeIpForwardEntry-Funktion muss verwendet werden, um die Member eines MIB_IPFORWARD_ROW2 Struktureintrags mit Standardwerten für einen IP-Routeneintrag zur späteren Verwendung mit der CreateIpForwardEntry2-Funktion zu initialisieren.

Bei der Eingabe muss InitializeIpForwardEntry eine neue MIB_IPFORWARD_ROW2-Struktur übergeben werden, die initialisiert werden soll.

Bei der Ausgabe werden die Elemente ValidLifetime und PreferredLifetime der MIB_IPFORWARD_ROW2 Struktur, auf die vom Row-Parameter verwiesen wird, auf unendlich initialisiert, und die Elemente Loopback, AutoconfigureAddress, Publish und Immortal werden zu TRUE initialisiert. Darüber hinaus werden die Elemente SitePrefixLength, Metric und Protocol auf einen ungültigen Wert festgelegt, und andere Felder werden auf Null initialisiert.

Nach dem Aufrufen von InitializeIpForwardEntry kann eine Anwendung dann die Member im MIB_IPFORWARD_ROW2 Eintrag ändern, den sie ändern möchte, und dann CreateIpForwardEntry2 aufrufen, um den neuen IP-Routeneintrag 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