Freigeben über


InitializeIpForwardEntry-Funktion (netioapi.h)

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

Weitere Informationen

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2