struttura MIB_IPFORWARD_ROW2

Articolo
06/15/2023

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
Identificatore univoco locale (LUID) per l'interfaccia di rete associata a questa voce di route IP.
InterfaceIndex
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
Prefisso dell'indirizzo IP per l'indirizzo IP di destinazione per questa route.
NextHop
Per una route remota, l'indirizzo IP del sistema o del gateway successivo che si trova lungo la route. 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
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 in genere utilizzato per rappresentare un valore non valido.
ValidLifetime
Tempo massimo, espresso in secondi, in cui la voce di route IP è valida. Un valore di 0xffffffff viene considerato infinito.
PreferredLifetime
Tempo preferito, in secondi, in cui la voce di route IP è valida. Un valore di 0xffffffff viene considerato infinito.
Metrica
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 metrica di interfaccia specificata nel membro Metrica della struttura MIB_IPINTERFACE_ROW aggiunta all'offset della metrica di route specificato in questo membro Metrica . 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 IP Forwarding Table MIB.
Protocollo
Tipo di meccanismo di routing NL_ROUTE_PROTOCOL con cui è stata aggiunta questa route IP.
Loopback
Valore che specifica se la route è una route di loopback (il gateway si trova nell'host locale).
AutoconfigureAddress
Valore che specifica se l'indirizzo IP è configurato automaticamente.
Pubblica
Valore che specifica se la route viene pubblicata.
Immortale
Valore che specifica se la route è immortale.
Age
Numero di secondi dall'aggiunta o modifica della route nella tabella di routing di rete.
Origine
Tipo di origine della route IP NL_ROUTE_ORIGIN .

Commenti

La funzione GetIpForwardTable2 enumera le voci di route IP in un computer 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 il prefisso e i membri PrefixLength di IP_ADDRESS_PREFIX impostato 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 una particolare interfaccia di rete 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 di tempo. La metrica automatica è una funzionalità di Windows XP e versioni successive dei sistemi operativi Windows che configura automaticamente la metrica per le route locali basate sulla velocità di collegamento. Per impostazione predefinita, la funzionalità di metrica automatica è abilitata (il membro UseAutomaticMetric della struttura MIB_IPINTERFACE_ROW è impostato su TRUE) in Windows XP e versioni successive. È anche possibile configurare manualmente questa funzionalità 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 questo offset della metrica di route aggiunto alla metrica di interfaccia specificata nel membro Metrica della struttura MIB_IPINTERFACE_ROW dell'interfaccia associata. Un driver può recuperare la metrica dell'interfaccia chiamando la funzione GetIpInterfaceEntry .