MIB_IF_ROW2 struttura (netioapi.h)
La struttura MIB_IF_ROW2 archivia informazioni su un'interfaccia specifica.
Sintassi
typedef struct _MIB_IF_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
GUID InterfaceGuid;
WCHAR Alias[IF_MAX_STRING_SIZE + 1];
WCHAR Description[IF_MAX_STRING_SIZE + 1];
ULONG PhysicalAddressLength;
UCHAR PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
UCHAR PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH];
ULONG Mtu;
IFTYPE Type;
TUNNEL_TYPE TunnelType;
NDIS_MEDIUM MediaType;
NDIS_PHYSICAL_MEDIUM PhysicalMediumType;
NET_IF_ACCESS_TYPE AccessType;
NET_IF_DIRECTION_TYPE DirectionType;
struct {
BOOLEAN HardwareInterface : 1;
BOOLEAN FilterInterface : 1;
BOOLEAN ConnectorPresent : 1;
BOOLEAN NotAuthenticated : 1;
BOOLEAN NotMediaConnected : 1;
BOOLEAN Paused : 1;
BOOLEAN LowPower : 1;
BOOLEAN EndPointInterface : 1;
} InterfaceAndOperStatusFlags;
IF_OPER_STATUS OperStatus;
NET_IF_ADMIN_STATUS AdminStatus;
NET_IF_MEDIA_CONNECT_STATE MediaConnectState;
NET_IF_NETWORK_GUID NetworkGuid;
NET_IF_CONNECTION_TYPE ConnectionType;
ULONG64 TransmitLinkSpeed;
ULONG64 ReceiveLinkSpeed;
ULONG64 InOctets;
ULONG64 InUcastPkts;
ULONG64 InNUcastPkts;
ULONG64 InDiscards;
ULONG64 InErrors;
ULONG64 InUnknownProtos;
ULONG64 InUcastOctets;
ULONG64 InMulticastOctets;
ULONG64 InBroadcastOctets;
ULONG64 OutOctets;
ULONG64 OutUcastPkts;
ULONG64 OutNUcastPkts;
ULONG64 OutDiscards;
ULONG64 OutErrors;
ULONG64 OutUcastOctets;
ULONG64 OutMulticastOctets;
ULONG64 OutBroadcastOctets;
ULONG64 OutQLen;
} MIB_IF_ROW2, *PMIB_IF_ROW2;
Members
InterfaceLuid
Tipo: NET_LUID
Identificatore univoco locale (LUID) per l'interfaccia di rete.
InterfaceIndex
Tipo: NET_IFINDEX
Indice che identifica l'interfaccia di rete. Questo valore di indice può cambiare quando una scheda di rete è disabilitata e quindi abilitata e non deve essere considerata persistente.
InterfaceGuid
Tipo: GUID
GUID per l'interfaccia di rete.
Alias[IF_MAX_STRING_SIZE + 1]
Tipo: WCHAR[IF_MAX_STRING_SIZE + 1]
Stringa Unicode con terminazione NULL contenente il nome alias dell'interfaccia di rete.
Description[IF_MAX_STRING_SIZE + 1]
Tipo: WCHAR[IF_MAX_STRING_SIZE + 1]
Stringa Unicode con terminazione NULL contenente una descrizione dell'interfaccia di rete.
PhysicalAddressLength
Tipo: ULONG
Lunghezza, in byte, dell'indirizzo hardware fisico specificato dal membro PhysicalAddress .
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Tipo: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Indirizzo hardware fisico della scheda per questa interfaccia di rete.
PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Tipo: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Indirizzo hardware fisico permanente della scheda per questa interfaccia di rete.
Mtu
Tipo: ULONG
Dimensioni massime dell'unità di trasmissione (MTU) in byte per questa interfaccia di rete.
Type
Tipo: IFTYPE
Tipo di interfaccia definito dall'autorità dei nomi assegnati internet (IANA). Per altre informazioni, vedere http://www.iana.org/assignments/ianaiftype-mib. I valori possibili per il tipo di interfaccia sono elencati nel file di intestazione Ipifcons.h .
La tabella seguente elenca i valori comuni per il tipo di interfaccia anche se sono possibili molti altri valori.
TunnelType
Tipo: TUNNEL_TYPE
Metodo di incapsulamento usato da un tunnel se il membro Type è IF_TYPE_TUNNEL. Il tipo di tunnel è definito dall'autorità IANA (Internet Assigned Name Authority). Per altre informazioni, vedere http://www.iana.org/assignments/ianaiftype-mib. Questo membro può essere uno dei valori del tipo di enumerazione TUNNEL_TYPE definito nel file di intestazione Ifdef.h .
MediaType
Tipo: NDIS_MEDIUM
Tipo di supporto NDIS per l'interfaccia. Questo membro può essere uno dei valori del tipo di enumerazione NDIS_MEDIUM definito nel file di intestazione Ntddndis.h .
PhysicalMediumType
Tipo: NDIS_PHYSICAL_MEDIUM
Tipo di supporto fisico NDIS. Questo membro può essere uno dei valori del tipo di enumerazione NDIS_PHYSICAL_MEDIUM definito nel file di intestazione Ntddndis.h .
AccessType
Tipo: NET_IF_ACCESS_TYPE
Tipo di accesso all'interfaccia. Questo membro può essere uno dei valori del tipo di enumerazione NET_IF_ACCESS_TYPE definito nel file di intestazione Ifdef.h .
DirectionType
Tipo: NET_IF_DIRECTION_TYPE
Tipo di direzione dell'interfaccia. Questo membro può essere uno dei valori del tipo di enumerazione NET_IF_DIRECTION_TYPE definito nel file di intestazione Ifdef.h .
InterfaceAndOperStatusFlags
Set di flag che forniscono informazioni sull'interfaccia. Questi flag vengono combinati con un'operazione OR bit per bit. Se nessuno dei flag si applica, questo membro viene impostato su zero.
InterfaceAndOperStatusFlags.HardwareInterface
Tipo: BOOLEAN Impostare se l'interfaccia di rete è per l'hardware.
InterfaceAndOperStatusFlags.FilterInterface
Tipo: BOOLEAN Impostare se l'interfaccia di rete è per un modulo di filtro.
InterfaceAndOperStatusFlags.ConnectorPresent
Tipo: BOOLEAN Impostare se un connettore è presente nell'interfaccia di rete. Questo valore viene impostato se è presente una scheda di rete fisica.
InterfaceAndOperStatusFlags.NotAuthenticated
Tipo: BOOLEAN Impostare se la porta predefinita per l'interfaccia di rete non è autenticata. Se un'interfaccia di rete non viene autenticata dalla destinazione, l'interfaccia di rete non è in modalità operativa. Anche se questo vale sia per le connessioni di rete cablate che per le connessioni di rete wireless, l'autenticazione è più comune per le connessioni di rete wireless.
InterfaceAndOperStatusFlags.NotMediaConnected
Tipo: BOOLEAN Impostare se l'interfaccia di rete non è in uno stato connesso al supporto. Se un cavo di rete è scollegato per una rete cablata, verrà impostato. Per una rete wireless, questa opzione è impostata per la scheda di rete non connessa a una rete.
InterfaceAndOperStatusFlags.Paused
Tipo: BOOLEAN Impostare se lo stack di rete per l'interfaccia di rete si trova nello stato di sospensione o sospensione. Ciò non significa che il computer si trova in uno stato di ibernazione.
InterfaceAndOperStatusFlags.LowPower
Tipo: BOOLEAN Impostare se l'interfaccia di rete si trova in uno stato di alimentazione insufficiente.
InterfaceAndOperStatusFlags.EndPointInterface
Tipo: BOOLEAN Impostare se l'interfaccia di rete è un dispositivo endpoint e non un'interfaccia di rete vera che si connette a una rete. Questa impostazione può essere impostata da dispositivi come smartphone che usano l'infrastruttura di rete per comunicare con il PC, ma non forniscono connettività a una rete esterna. Per impostare questo flag è obbligatorio per questi tipi di dispositivi.
OperStatus
Tipo: IF_OPER_STATUS
Stato operativo per l'interfaccia come definito in RFC 2863 come IfOperStatus. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc2863.txt. Questo membro può essere uno dei valori del tipo di enumerazione IF_OPER_STATUS definito nel file di intestazione Ifdef.h .
AdminStatus
Tipo: NET_IF_ADMIN_STATUS
Stato amministrativo per l'interfaccia come definito in RFC 2863. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc2863.txt. Questo membro può essere uno dei valori del tipo di enumerazione NET_IF_ADMIN_STATUS definito nel file di intestazione Ifdef.h .
MediaConnectState
Tipo: NET_IF_MEDIA_CONNECT_STATE
Stato della connessione dell'interfaccia. Questo membro può essere uno dei valori del tipo di enumerazione NET_IF_MEDIA_CONNECT_STATE definito nel file di intestazione Ifdef.h .
NetworkGuid
Tipo: NET_IF_NETWORK_GUID
GUID associato alla rete a cui appartiene l'interfaccia.
ConnectionType
Tipo: NET_IF_CONNECTION_TYPE
Tipo di connessione dell'interfaccia di rete NDIS. Questo membro può essere uno dei valori del tipo di enumerazione NET_IF_CONNECTION_TYPE definito nel file di intestazione Ifdef.h .
TransmitLinkSpeed
Tipo: ULONG64
Velocità in bit al secondo del collegamento di trasmissione.
ReceiveLinkSpeed
Tipo: ULONG64
Velocità in bit al secondo del collegamento di ricezione.
InOctets
Tipo: ULONG64
Numero di ottetti di dati ricevuti senza errori tramite questa interfaccia. Questo valore include ottetti in pacchetti unicast, broadcast e multicast.
InUcastPkts
Tipo: ULONG64
Numero di pacchetti unicast ricevuti senza errori tramite questa interfaccia.
InNUcastPkts
Tipo: ULONG64
Numero di pacchetti non unicast ricevuti senza errori tramite questa interfaccia. Questo valore include pacchetti broadcast e multicast.
InDiscards
Tipo: ULONG64
Numero di pacchetti in ingresso che sono stati scelti per essere eliminati anche se non sono stati rilevati errori per impedire il recapito dei pacchetti a un protocollo di livello superiore.
InErrors
Tipo: ULONG64
Numero di pacchetti in ingresso eliminati a causa di errori.
InUnknownProtos
Tipo: ULONG64
Numero di pacchetti in ingresso eliminati perché il protocollo era sconosciuto.
InUcastOctets
Tipo: ULONG64
Numero di ottetti di dati ricevuti senza errori nei pacchetti unicast tramite questa interfaccia.
InMulticastOctets
Tipo: ULONG64
Numero di ottetti di dati ricevuti senza errori nei pacchetti multicast tramite questa interfaccia.
InBroadcastOctets
Tipo: ULONG64
Numero di ottetti di dati ricevuti senza errori nei pacchetti trasmessi tramite questa interfaccia.
OutOctets
Tipo: ULONG64
Numero di ottetti di dati trasmessi senza errori tramite questa interfaccia. Questo valore include ottetti in pacchetti unicast, broadcast e multicast.
OutUcastPkts
Tipo: ULONG64
Numero di pacchetti unicast trasmessi senza errori tramite questa interfaccia.
OutNUcastPkts
Tipo: ULONG64
Numero di pacchetti non unicast trasmessi senza errori tramite questa interfaccia. Questo valore include pacchetti broadcast e multicast.
OutDiscards
Tipo: ULONG64
Numero di pacchetti in uscita che sono stati eliminati anche se non hanno errori.
OutErrors
Tipo: ULONG64
Numero di pacchetti in uscita eliminati a causa di errori.
OutUcastOctets
Tipo: ULONG64
Numero di ottetti di dati trasmessi senza errori nei pacchetti unicast tramite questa interfaccia.
OutMulticastOctets
Tipo: ULONG64
Numero di ottetti di dati trasmessi senza errori nei pacchetti multicast tramite questa interfaccia.
OutBroadcastOctets
Tipo: ULONG64
Numero di ottetti di dati trasmessi senza errori nei pacchetti trasmessi tramite questa interfaccia.
OutQLen
Tipo: ULONG64
Lunghezza della coda di trasmissione. Questo campo non è attualmente utilizzato.
Commenti
La struttura MIB_IF_ROW2 è definita in Windows Vista e versioni successive.
I valori per il campo Type sono definiti nel file di intestazione Ipifcons.h . Sono attualmente supportati solo i valori possibili elencati nella descrizione del membro Type .
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 (include Iphlpapi.h) |