Funzione InitializeIpForwardEntry (netioapi.h)

Articolo
03/05/2024

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