Condividi tramite


Funzione InitializeIpForwardEntry (netioapi.h)

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

Sintassi

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

Parametri

[out] Row

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

Questa funzione non restituisce un valore.

Commenti

La funzione InitializeIpForwardEntry viene definita in Windows Vista e versioni successive.

La funzione InitializeIpForwardEntry deve essere utilizzata per inizializzare i membri di una voce di struttura MIB_IPFORWARD_ROW2 con valori predefiniti per una voce di route IP per usarla successivamente con la funzione CreateIpForwardEntry2 .

In input , InitializeIpForwardEntry deve essere passata una nuova struttura MIB_IPFORWARD_ROW2 per inizializzare.

Nell'output, i membri ValidLifetime e PreferredLifetime della struttura MIB_IPFORWARD_ROW2 a cui punta il parametro Row verranno inizializzati in infinito e i membri Loopback, AutoconfigureAddress, Publish e Immortal verranno inizializzati su TRUE. Inoltre, i membri SitePrefixLength, Metric e Protocol vengono impostati su un valore non valido e altri campi vengono inizializzati su zero.

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

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione netioapi.h (include Iphlpapi.h)
Libreria Iphlpapi.lib
DLL Iphlpapi.dll

Vedi anche

CreateIpForwardEntry2

DeleteIpForwardEntry2

GetBestRoute2

GetIpForwardEntry2

GetIpForwardTable2

MIB_IPFORWARD_ROW2

MIB_IPFORWARD_TABLE2

NotifyRouteChange2

SetIpForwardEntry2