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]
  All'ingresso, un puntatore a una voce di struttura MIB_IPFORWARD_ROW2 per una voce di route IP.

  In caso di restituzione, 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 da usare successivamente con la funzione CreateIpForwardEntry2.

All'input, il driver deve passare InitializeIpForwardEntry una nuova struttura MIB_IPFORWARD_ROW2 da inizializzare.

Nell'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, Publishe Immortal
  Impostare su TRUE.

• SitePrefixLength, Metrice Protocol
  Impostare su valori non validi.

• Tutti gli altri membri
  Impostare su zero.

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

Fabbisogno

Piattaforma di destinazione	universale
Versione	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	Netioapi.h (include Netioapi.h)
Biblioteca	Netio.lib
IRQL	< DISPATCH_LEVEL

Vedere anche

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2