Funzione InitializeIpForwardEntry

La funzione InitializeIpForwardEntry inizializza una struttura MIB_IPFORWARD_ROW2 con valori predefiniti per una voce di route IP in un computer locale.

Sintassi

VOID NETIOAPI_API_ InitializeIpForwardEntry(
  _Out_ PMIB_IPFORWARD_ROW2 Row
);

Parametri

  • Riga [out]
    In ingresso, un puntatore a una voce di struttura MIB_IPFORWARD_ROW2 per una voce di route IP.

    In caso di ritorno, la struttura MIB_IPFORWARD_ROW2 a cui punta questo parametro viene inizializzata con valori predefiniti per una voce di route IP.

Valore restituito

nessuno

Osservazioni

Il driver deve usare la funzione InitializeIpForwardEntry per inizializzare i membri di una voce di struttura MIB_IPFORWARD_ROW2 con valori predefiniti per una voce di route IP per un uso successivo con la funzione CreateIpForwardEntry2 .

In input, il driver deve passare InitializeIpForwardEntry una nuova struttura MIB_IPFORWARD_ROW2 per inizializzare.

In output, i membri della struttura MIB_IPFORWARD_ROW2 a cui punta il parametro Row vengono inizializzati come indicato di seguito.

  • ValidLifetime e PreferredLifetime
    Impostare su un valore infinito,

  • Loopback, AutoconfigureAddress, Pubblica e Immortale
    Impostare su TRUE.

  • SitePrefixLength, metrica e protocollo
    Impostare su valori non validi.

  • Tutti gli altri membri
    Imposta su zero.

Dopo che un driver chiama InitializeIpForwardEntry, il driver può quindi modificare i membri nella voce MIB_IPFORWARD_ROW2 che vuole modificare e quindi chiamare CreateIpForwardEntry2 per aggiungere la nuova voce di route IP al computer locale.

Requisiti

Piattaforma di destinazione

Universale

Versione

Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.

Intestazione

Netioapi.h (include Netioapi.h)

Libreria

Netio.lib

IRQL

< DISPATCH_LEVEL

Vedi anche

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2