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 |