Freigeben über


InitializeIpForwardEntry-Funktion

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

Syntax

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Parameter

  • Zeile [out]
    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

Keine

Bemerkungen

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

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

In der Ausgabe werden die Member der MIB_IPFORWARD_ROW2-Struktur, auf die der Row-Parameter verweist, wie folgt initialisiert.

  • ValidLifetime und PreferredLifetime
    Legen Sie auf einen unendlichen Wert fest,

  • Loopback, AutoconfigureAddress, Publish und Immortal
    Legen Sie auf TRUE fest.

  • SitePrefixLength, Metrik und Protokoll
    Legen Sie auf ungültige Werte fest.

  • Alle anderen Mitglieder
    Auf NULL festlegen.

Nachdem ein Treiber InitializeIpForwardEntry aufgerufen hat, kann der Treiber die Member im MIB_IPFORWARD_ROW2 Eintrag ändern, den er ändern möchte, und dann CreateIpForwardEntry2 aufrufen, um dem lokalen Computer den neuen IP-Routeneintrag hinzuzufügen.

Anforderungen

Zielplattform

Universell

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Header

Netioapi.h (einschließlich Netioapi.h)

Bibliothek

Netio.lib

IRQL

< DISPATCH_LEVEL

Weitere Informationen

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2