struttura MIB_IPFORWARD_ROW2 (netioapi.h)

Articolo
01/27/2024

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
MIB_IPPROTO_OTHER 1	Il meccanismo di routing non è stato specificato.
MIB_IPPROTO_LOCAL 2	Interfaccia locale.
MIB_IPPROTO_NETMGMT 3	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 .
MIB_IPPROTO_ICMP 4	Risultato di un reindirizzamento ICMP.
MIB_IPPROTO_EGP 5	Il protocollo EGP (Exterior Gateway Protocol), un protocollo di routing dinamico.
MIB_IPPROTO_GGP 6	Il protocollo GGP (Gateway-to-Gateway Protocol), un protocollo di routing dinamico.
MIB_IPPROTO_HELLO 7	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.
MIB_IPPROTO_RIP 8	Berkeley Routing Information Protocol (RIP) o RIP-II, un protocollo di routing dinamico.
MIB_IPPROTO_IS_IS 9	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).
MIB_IPPROTO_ES_IS 10	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).
MIB_IPPROTO_CISCO 11	Cisco Interior Gateway Routing Protocol (IGRP), un protocollo di routing dinamico.
MIB_IPPROTO_BBN 12	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.
MIB_IPPROTO_OSPF 13	Il protocollo Open Shortest Path First (OSPF), un protocollo di routing dinamico.
MIB_IPPROTO_BGP 14	Border Gateway Protocol (BGP), un protocollo di routing dinamico.
MIB_IPPROTO_NT_AUTOSTATIC 10002	Voce specifica di Windows aggiunta originariamente da un protocollo di routing, ma che ora è statica.
MIB_IPPROTO_NT_STATIC 10006	Una voce specifica di Windows aggiunta come route statica dall'interfaccia utente di routing o da un comando di routing.
MIB_IPPROTO_NT_STATIC_NON_DOD 10007	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 .

Valore	Significato
NlroManual 0	Risultato della configurazione manuale.
NlroWellKnown 1	Un percorso noto.
NlroDHCP 2	Risultato della configurazione DHCP.
NlroRouterAdvertisement 3	Risultato dell'annuncio del router.
Nlro6to4 4	Risultato del tunneling 6to4.

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)