struttura MIB_IPFORWARDROW (ipmib.h)
La struttura MIB_IPFORWARDROW contiene informazioni che descrivono una route di rete IPv4.
Sintassi
typedef struct _MIB_IPFORWARDROW {
DWORD dwForwardDest;
DWORD dwForwardMask;
DWORD dwForwardPolicy;
DWORD dwForwardNextHop;
IF_INDEX dwForwardIfIndex;
union {
DWORD dwForwardType;
MIB_IPFORWARD_TYPE ForwardType;
};
union {
DWORD dwForwardProto;
MIB_IPFORWARD_PROTO ForwardProto;
};
DWORD dwForwardAge;
DWORD dwForwardNextHopAS;
DWORD dwForwardMetric1;
DWORD dwForwardMetric2;
DWORD dwForwardMetric3;
DWORD dwForwardMetric4;
DWORD dwForwardMetric5;
} MIB_IPFORWARDROW, *PMIB_IPFORWARDROW;
Members
dwForwardDest
Tipo: DWORD
Indirizzo IPv4 di destinazione della route. Una voce con indirizzo IPv4 0.0.0.0 è considerata una route predefinita. Questo membro non può essere impostato su un indirizzo IPv4 multicast (classe D).
dwForwardMask
Tipo: DWORD
Subnet mask IPv4 da usare con l'indirizzo IPv4 di destinazione prima di essere confrontato con il valore nel membro dwForwardDest .
Il valore dwForwardMask deve essere applicato all'indirizzo IPv4 di destinazione (logico e operativo) prima di un confronto con il valore nel membro dwForwardDest .
dwForwardPolicy
Tipo: DWORD
Set di condizioni che causerebbero la selezione di una route multi-percorso (il set di hop successivi per una determinata destinazione). Questo membro è in genere in formato TOS IP. Questa codifica di questo membro è descritta in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
dwForwardNextHop
Tipo: DWORD
Per le route remote, l'indirizzo IPv4 del sistema successivo instradato. In caso contrario, questo membro deve essere un indirizzo IPv4 di 0.0.0.0.
dwForwardIfIndex
Tipo: DWORD
Indice dell'interfaccia locale tramite cui deve essere raggiunto l'hop successivo di questa route.
dwForwardType
Tipo: DWORD
Tipo di route come descritto in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
Questo membro può essere uno dei valori definiti nel file di intestazione Iprtmib.h .
In Windows Vista e versioni successive i file di intestazione sono stati riorganizzati e questo membro può essere uno dei valori del tipo di enumerazione MIB_IPFORWARD_TYPE definito nel file di intestazione Ipmib.h . Si noti che l'intestazione Ipmib.h viene automaticamente inclusa dal file di intestazione Iprtrmib.h , incluso automaticamente dall'intestazione Iphlpapi.h . I file di intestazione Iprtrmib.h e Ipmib.h non devono mai essere usati direttamente.
L'elenco seguente mostra i valori possibili per questo membro.
ForwardType
dwForwardProto
Tipo: DWORD
Il protocollo o il meccanismo di routing che ha generato la route come descritto in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt. Per un elenco di possibili identificatori di protocollo usati dai protocolli di routing, vedere Identificatori di protocollo.
Questo membro può essere uno dei valori definiti nel file di intestazione Iprtmib.h . I valori per questo membro possono essere uno dei valori MIB_IPPROTO_xxx definiti nel file di intestazione Iprtmib.h o uno dei valori PROTO_IP_xxx definiti nel file di intestazione routprot.h , poiché questi valori sono gli stessi.
In Windows Vista e versioni successive i file di intestazione sono stati riorganizzati e questo membro può essere uno dei valori definiti nel file di intestazione Nldef.h . 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 |
|---|---|
|
Altri protocolli non specificati in RFC 1354. |
|
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 CreateIpForwardEntry, DeleteIpForwardEntry o SetIpForwardEntry . |
|
Risultato del 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). |
ForwardProto
dwForwardAge
Tipo: DWORD
Numero di secondi dall'aggiunta o modifica della route nella tabella di routing di rete.
dwForwardNextHopAS
Tipo: DWORD
Numero di sistema autonomo dell'hop successivo. Quando questo membro è sconosciuto o non rilevante per il protocollo o il meccanismo di routing specificato in dwForwardProto, questo valore deve essere impostato su zero. Questo valore è documentato in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
dwForwardMetric1
Tipo: DWORD
Valore della metrica di routing primario per questa route. La semantica di questa metrica è determinata dal protocollo di routing specificato nel membro dwForwardProto . Se questa metrica non viene usata, il relativo valore deve essere impostato su -1. Questo valore è documentato in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
dwForwardMetric2
Tipo: DWORD
Valore della metrica di routing alternativo per questa route. La semantica di questa metrica è determinata dal protocollo di routing specificato nel membro dwForwardProto . Se questa metrica non viene usata, il relativo valore deve essere impostato su -1. Questo valore è documentato in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
dwForwardMetric3
Tipo: DWORD
Valore della metrica di routing alternativo per questa route. La semantica di questa metrica è determinata dal protocollo di routing specificato nel membro dwForwardProto . Se questa metrica non viene usata, il relativo valore deve essere impostato su -1. Questo valore è documentato in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
dwForwardMetric4
Tipo: DWORD
Valore della metrica di routing alternativo per questa route. La semantica di questa metrica è determinata dal protocollo di routing specificato nel membro dwForwardProto . Se questa metrica non viene usata, il relativo valore deve essere impostato su -1. Questo valore è documentato in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
dwForwardMetric5
Tipo: DWORD
Valore della metrica di routing alternativo per questa route. La semantica di questa metrica è determinata dal protocollo di routing specificato nel membro dwForwardProto . Se questa metrica non viene usata, il relativo valore deve essere impostato su -1. Questo valore è documentato in RFC 1354. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc1354.txt.
Commenti
La funzione GetIpForwardTable enumera le voci di route IPv4 in un sistema locale e restituisce queste informazioni in una struttura MIB_IPFORWARDTABLE che contiene una matrice di voci di struttura MIB_IPFORWARDROW .
I membri dwForwardDest, dwForwardMask e dwForwardNextHop della struttura MIB_IPFORWARDROW rappresentano gli indirizzi IPv4 nell'ordine dei byte di rete.
Il membro dwForwardProto della struttura MIB_IPFORWARDROW specifica il protocollo o il meccanismo di routing che ha generato la route. Gli identificatori del protocollo di routing vengono usati per identificare le informazioni di route per il protocollo di routing specificato. Ad esempio, MIB_IPPROTO_NETMGMT 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 CreateIpForwardEntry, DeleteIpForwardEntry o SetIpForwardEntry . Per un elenco dei protocolli e dei meccanismi di routing possibili, vedere Identificatori di protocollo.
Un indirizzo IPv4 0.0.0.0 nel membro dwForwardDest della struttura MIB_IPFORWARDROW è considerato una route predefinita. Il MIB_IPFORWARDTABLE può contenere più voci MIB_IPFORWARDROW con il membro dwForwardDest impostato su 0.0.0.0 quando sono installate più schede di rete.
Quando dwForwardAge è impostato su INFINITE, la route non verrà rimossa in base a un timeout
Valore. Qualsiasi altro valore per dwForwardAge specifica il numero di secondi dopo l'aggiunta o la modifica della route nella tabella di routing di rete.
In Windows Server 2003 o Windows 2000 Server quando il servizio routing e accesso remoto (RRAS) è in esecuzione, le voci MIB_IPFORWARDROW restituite hanno i membri dwForwardType e dwForwardAge impostati su zero.
In Windows Vista e Windows Server 2008 la metrica di route specificata nel membro dwForwardMetric1 della struttura MIB_IPFORWARDROW rappresenta una combinazione della metrica di route aggiunta alla metrica di interfaccia specificata nel membro Metrica della struttura MIB_IPINTERFACE_ROW dell'interfaccia associata. Pertanto, il membro dwForwardMetric1 della struttura MIB_IPFORWARDROW deve essere uguale o maggiore del membro Metrico della struttura MIB_IPINTERFACE_ROW associata. Se un'applicazione vuole impostare la metrica di route su 0, il membro dwForwardMetric1 della struttura MIB_IPFORWARDROW deve essere impostato su uguale al valore della metrica di interfaccia specificata nel membro Metrica della struttura di MIB_IPINTERFACE_ROW associata. Un'applicazione può recuperare la metrica dell'interfaccia chiamando la funzione GetIpInterfaceEntry .
Un numero di membri della struttura MIB_IPFORWARDROW non è attualmente usato dal routing IPv4. Questi membri includono dwForwardPolicy, dwForwardNextHopAS, dwForwardMetric2, dwForwardMetric3, dwForwardMetric4 e dwForwardMetric5.
In Microsoft Windows Software Development Kit (SDK) rilasciato per Windows Vista e versioni successive, l'organizzazione dei file di intestazione è cambiata. Questa struttura è definita nel file di intestazione Ipmib.h , non nel file di intestazione Iprtrmib.h . Si noti che il file di intestazione Ipmib.h viene automaticamente incluso in Iprtrmib.h, incluso automaticamente nel file di intestazione Iphlpapi.h . I file di intestazione Ipmib.h e Iprtrmib.h non devono mai essere usati direttamente.
Esempio
Per visualizzare un esempio che recupera la struttura MIB_IPFORWARDTABLE e quindi stampa le voci della struttura MIB_IPFORWARDROW in questa tabella, vedere la funzione GetIpForwardTable .
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | ipmib.h (include Iphlpapi.h) |