struttura MIB_IPFORWARD_ROW2 (netioapi.h)
La struttura MIB_IPFORWARD_ROW2 archivia informazioni su una voce di route IP.
Sintassi
typedef struct _MIB_IPFORWARD_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
IP_ADDRESS_PREFIX DestinationPrefix;
SOCKADDR_INET NextHop;
UCHAR SitePrefixLength;
ULONG ValidLifetime;
ULONG PreferredLifetime;
ULONG Metric;
NL_ROUTE_PROTOCOL Protocol;
BOOLEAN Loopback;
BOOLEAN AutoconfigureAddress;
BOOLEAN Publish;
BOOLEAN Immortal;
ULONG Age;
NL_ROUTE_ORIGIN Origin;
} MIB_IPFORWARD_ROW2, *PMIB_IPFORWARD_ROW2;
Members
InterfaceLuid
Tipo: NET_LUID
Identificatore univoco locale (LUID) per l'interfaccia di rete associata a questa voce di route IP.
InterfaceIndex
Tipo: NET_IFINDEX
Valore dell'indice locale per l'interfaccia di rete associata a questa voce di route IP. Questo valore di indice può cambiare quando una scheda di rete è disabilitata e quindi abilitata o in altre circostanze e non deve essere considerata persistente.
DestinationPrefix
Tipo: IP_ADDRESS_PREFIX
Prefisso dell'indirizzo IP per l'indirizzo IP di destinazione per questa route.
NextHop
Tipo: SOCKADDR_INET
Per una route remota, l'indirizzo IP del sistema o del gateway successivo instradato. Se la route si trova a un indirizzo di loopback locale o a un indirizzo IP nel collegamento locale, l'hop successivo non viene specificato (tutti gli zeri). Per una route di loopback locale, questo membro deve essere un indirizzo IPv4 0.0.0.0 per una voce di route IPv4 o un indirizzo IPv6 di 0::0 per una voce di route IPv6.
SitePrefixLength
Tipo: UCHAR
Lunghezza, in bit, del prefisso del sito o parte di rete dell'indirizzo IP per questa route. Per una voce di route IPv4, qualsiasi valore maggiore di 32 è un valore non valido. Per una voce di route IPv6, qualsiasi valore maggiore di 128 è un valore non valido. Il valore 255 viene comunemente usato per rappresentare un valore non valido.
ValidLifetime
Tipo: ULONG
Tempo massimo, espresso in secondi, in cui la voce di route IP è valida. Un valore di 0xffffffff viene considerato infinito.
PreferredLifetime
Tipo: ULONG
Tempo preferito, in secondi, in cui la voce di route IP è valida. Un valore di 0xffffffff viene considerato infinito.
Metric
Tipo: ULONG
Valore di offset della metrica di route per questa voce di route IP. Si noti che la metrica di route effettiva usata per calcolare la preferenza di route è la somma della metrica di interfaccia specificata nel membro Metrica della struttura MIB_IPINTERFACE_ROW e l'offset della metrica di route specificato in questo membro. La semantica di questa metrica è determinata dal protocollo di routing specificato nel membro Protocol . Se questa metrica non viene usata, il relativo valore deve essere impostato su -1. Questo valore è documentato in RFC 4292. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc4292.txt.
Protocol
Tipo: NL_ROUTE_PROTOCOL
Meccanismo di routing del modo in cui è stata aggiunta questa route IP. Questo membro può essere uno dei valori del tipo di enumerazione NL_ROUTE_PROTOCOL definito nel file di intestazione Nldef.h . Il membro è descritto in RFC 4292. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc4292.txt.
Si noti che l'intestazione Nldef.h viene inclusa automaticamente dal file di intestazione Ipmib.h che viene automaticamente incluso dall'intestazione Iprtrmib.h . L'intestazione Iphlpapi.h include automaticamente il file di intestazione Iprtrmib.h . I file di intestazione Iprtrmib.h, Ipmib.h e Nldef.h non devono mai essere usati direttamente.
L'elenco seguente mostra i valori possibili per questo membro.
| Valore | Significato |
|---|---|
|
Il meccanismo di routing non è stato specificato. |
|
Interfaccia locale. |
|
Route statica. Questo valore viene usato per identificare le informazioni di route per il routing IP impostato tramite la gestione di rete, ad esempio IL PROTOCOLLO DCHP (Dynamic Host Configuration Protocol), Simple Network Management Protocol (SNMP) o tramite chiamate alle funzioni CreateIpForwardEntry2, DeleteIpForwardEntry2 o SetIpForwardEntry2 . |
|
Risultato di un reindirizzamento ICMP. |
|
Il protocollo EGP (Exterior Gateway Protocol), un protocollo di routing dinamico. |
|
Il protocollo GGP (Gateway-to-Gateway Protocol), un protocollo di routing dinamico. |
|
Protocollo Hellospeak, protocollo di routing dinamico. Si tratta di una voce storica non più in uso ed è stato un protocollo di routing iniziale usato dai router ARPANET originali che hanno eseguito software speciale denominato protocollo di routing Fuzzball, talvolta chiamato Hellospeak, come descritto in RFC 891 e RFC 1305. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc891.txt e http://www.ietf.org/rfc/rfc1305.txt. |
|
Berkeley Routing Information Protocol (RIP) o RIP-II, un protocollo di routing dinamico. |
|
Protocollo intermedio da sistema a intermedio (IS-IS), un protocollo di routing dinamico. Il protocollo IS-IS è stato sviluppato per l'uso nella suite di protocolli OSI (Open Systems Interconnect). |
|
Protocollo End System-to-Intermediate System (ES-IS), un protocollo di routing dinamico. Il protocollo ES-IS è stato sviluppato per l'uso nella suite di protocolli OSI (Open Systems Interconnect). |
|
Cisco Interior Gateway Routing Protocol (IGRP), un protocollo di routing dinamico. |
|
Bolt, Beranek e Newman (BBN) Interior Gateway Protocol (IGP) che ha usato l'algoritmo Shortest Path First (SPF). Si tratta di un protocollo di routing dinamico iniziale. |
|
Il protocollo Open Shortest Path First (OSPF), un protocollo di routing dinamico. |
|
Border Gateway Protocol (BGP), un protocollo di routing dinamico. |
|
Voce specifica di Windows aggiunta originariamente da un protocollo di routing, ma che ora è statica. |
|
Una voce specifica di Windows aggiunta come route statica dall'interfaccia utente di routing o da un comando di routing. |
|
Una voce specifica di Windows aggiunta come route statica dall'interfaccia utente di routing o da un comando di routing, ad eccezione di queste route non causa Dial On Demand (DOD). |
Loopback
Tipo: BOOLEAN
Valore che specifica se la route è una route di loopback (il gateway si trova nell'host locale).
AutoconfigureAddress
Tipo: BOOLEAN
Valore che specifica se l'indirizzo IP è configurato automaticamente.
Publish
Tipo: BOOLEAN
Valore che specifica se la route viene pubblicata.
Immortal
Tipo: BOOLEAN
Valore che specifica se la route è immortale.
Age
Tipo: ULONG
Numero di secondi dopo l'aggiunta o la modifica della route nella tabella di routing di rete.
Origin
Tipo: NL_ROUTE_ORIGIN
Origine della route. Questo membro può essere uno dei valori del tipo di enumerazione NL_ROUTE_ORIGIN definito nel file di intestazione Nldef.h .
Commenti
La struttura MIB_IPFORWARD_ROW2 è definita in Windows Vista e versioni successive.
La funzione GetIpForwardTable2 enumera le voci di route IP in un sistema locale e restituisce queste informazioni in una struttura MIB_IPFORWARD_TABLE2 come matrice di voci MIB_IPFORWARD_ROW2 .
La funzione GetIpForwardEntry2 recupera una singola voce di route IP e restituisce queste informazioni in una struttura MIB_IPFORWARD_ROW2 .
Una voce con prefisso e i membri PrefixLength del IP_ADDRESS_PREFIX impostati su zero nel membro DestinationPrefix nella struttura MIB_IPFORWARD_ROW2 viene considerata una route predefinita. Il MIB_IPFORWARD_TABLE2 può contenere più voci MIB_IPFORWARD_ROW2 con il prefisso e i membri PrefixLength del IP_ADDRESS_PREFIX impostato su zero nel membro DestinationPrefix quando sono installate più schede di rete.
Il membro Metric di una voce di MIB_IPFORWARD_ROW2 è un valore assegnato a una route IP per un'interfaccia di rete specifica che identifica il costo associato all'uso di tale route. Ad esempio, la metrica può essere valutata in termini di velocità di collegamento, conteggio hop o ritardo del tempo. La metrica automatica è una funzionalità in Windows XP e versioni successive che configura automaticamente la metrica per le route locali basate sulla velocità di collegamento. La funzionalità di metrica automatica è abilitata per impostazione predefinita (il membro UseAutomaticMetric della struttura MIB_IPINTERFACE_ROW è impostato su TRUE) in Windows XP e versioni successive. Può anche essere configurato manualmente per assegnare una metrica specifica a una route IP.
La metrica di route specificata nel membro Metric della struttura MIB_IPFORWARD_ROW2 rappresenta solo l'offset della metrica di route. La metrica completa è una combinazione di questa metrica di route aggiunta alla metrica di interfaccia specificata nel membro Metrica della struttura MIB_IPINTERFACE_ROW dell'interfaccia associata. Un'applicazione può recuperare la metrica dell'interfaccia chiamando la funzione GetIpInterfaceEntry .
Si noti che il file di intestazione Netioapi.h viene incluso automaticamente nel file di intestazione Iphlpapi.h . Il file di intestazione Netioapi.h non deve mai essere usato direttamente.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | netioapi.h (includere Iphlpapi.h) |