MIB_IF_ROW2-Struktur (netioapi.h)
Die MIB_IF_ROW2-Struktur speichert Informationen zu einer bestimmten Schnittstelle.
Syntax
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;
Member
InterfaceLuid
Typ: NET_LUID
Der lokal eindeutige Bezeichner (LUID) für die Netzwerkschnittstelle.
InterfaceIndex
Typ: NET_IFINDEX
Der Index, der die Netzwerkschnittstelle identifiziert. Dieser Indexwert kann sich ändern, wenn ein Netzwerkadapter deaktiviert und dann aktiviert ist, und sollte nicht als persistent betrachtet werden.
InterfaceGuid
Typ: GUID
Die GUID für die Netzwerkschnittstelle.
Alias[IF_MAX_STRING_SIZE + 1]
Typ: WCHAR[IF_MAX_STRING_SIZE + 1]
Eine MIT NULL beendete Unicode-Zeichenfolge, die den Aliasnamen der Netzwerkschnittstelle enthält.
Description[IF_MAX_STRING_SIZE + 1]
Typ: WCHAR[IF_MAX_STRING_SIZE + 1]
Eine MIT NULL beendete Unicode-Zeichenfolge, die eine Beschreibung der Netzwerkschnittstelle enthält.
PhysicalAddressLength
Typ: ULONG
Die Länge der physischen Hardwareadresse in Bytes, die vom PhysicalAddress-Member angegeben wird.
PhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Typ: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Die physische Hardwareadresse des Adapters für diese Netzwerkschnittstelle.
PermanentPhysicalAddress[IF_MAX_PHYS_ADDRESS_LENGTH]
Typ: UCHAR[IF_MAX_PHYS_ADDRESS_LENGTH]
Die permanente physische Hardwareadresse des Adapters für diese Netzwerkschnittstelle.
Mtu
Typ: ULONG
Die maximale MTU-Größe (Transmission Unit) in Bytes für diese Netzwerkschnittstelle.
Type
Typ: IFTYPE
Der Von der Internet Assigned Names Authority (IANA) definierte Schnittstellentyp. Weitere Informationen finden Sie unter http://www.iana.org/assignments/ianaiftype-mib. Mögliche Werte für den Schnittstellentyp sind in der Headerdatei Ipifcons.h aufgeführt.
In der folgenden Tabelle sind allgemeine Werte für den Schnittstellentyp aufgeführt, obwohl viele andere Werte möglich sind.
TunnelType
Typ: TUNNEL_TYPE
Die Kapselungsmethode, die von einem Tunnel verwendet wird, wenn das Type-ElementIF_TYPE_TUNNEL ist. Der Tunneltyp wird von der Internet Assigned Names Authority (IANA) definiert. Weitere Informationen finden Sie unter http://www.iana.org/assignments/ianaiftype-mib. Dieses Element kann einer der Werte aus dem TUNNEL_TYPE Enumerationstyp sein, der in der Headerdatei "Ifdef.h " definiert ist.
MediaType
Typ: NDIS_MEDIUM
Der NDIS-Medientyp für die Schnittstelle. Dieser Member kann einer der Werte aus dem NDIS_MEDIUM Enumerationstyp sein, der in der Headerdatei "Ntddndis.h " definiert ist.
PhysicalMediumType
Typ: NDIS_PHYSICAL_MEDIUM
Der physische Mediumtyp NDIS. Dieser Member kann einer der Werte aus dem NDIS_PHYSICAL_MEDIUM Enumerationstyp sein, der in der Headerdatei "Ntddndis.h " definiert ist.
AccessType
Typ: NET_IF_ACCESS_TYPE
Der Schnittstellenzugriffstyp. Dieses Element kann einer der Werte aus dem NET_IF_ACCESS_TYPE Enumerationstyp sein, der in der Headerdatei "Ifdef.h " definiert ist.
DirectionType
Typ: NET_IF_DIRECTION_TYPE
Der Schnittstellenrichtungstyp. Dieses Element kann einer der Werte aus dem NET_IF_DIRECTION_TYPE Enumerationstyp sein, der in der Headerdatei "Ifdef.h " definiert ist.
InterfaceAndOperStatusFlags
Eine Reihe von Flags, die Informationen zur Schnittstelle bereitstellen. Diese Flags werden mit einem bitweisen OR-Vorgang kombiniert. Wenn keines der Flags zutrifft, wird dieses Element auf 0 festgelegt.
InterfaceAndOperStatusFlags.HardwareInterface
Typ: BOOLEAN Legen Sie fest, ob die Netzwerkschnittstelle für Hardware verwendet wird.
InterfaceAndOperStatusFlags.FilterInterface
Typ: BOOLEAN Legen Sie fest, ob die Netzwerkschnittstelle für ein Filtermodul verwendet wird.
InterfaceAndOperStatusFlags.ConnectorPresent
Typ: BOOLEAN Legen Sie fest, ob ein Connector auf der Netzwerkschnittstelle vorhanden ist. Dieser Wert wird festgelegt, wenn ein physischer Netzwerkadapter vorhanden ist.
InterfaceAndOperStatusFlags.NotAuthenticated
Typ: BOOLEAN Legen Sie fest, ob der Standardport für die Netzwerkschnittstelle nicht authentifiziert ist. Wenn eine Netzwerkschnittstelle nicht vom Ziel authentifiziert wird, befindet sich die Netzwerkschnittstelle nicht im Betriebsmodus. Obwohl dies sowohl für kabelgebundene als auch für drahtlose Netzwerkverbindungen gilt, ist die Authentifizierung bei drahtlosen Netzwerkverbindungen häufiger.
InterfaceAndOperStatusFlags.NotMediaConnected
Typ: BOOLEAN Legen Sie fest, wenn sich die Netzwerkschnittstelle nicht in einem mit Medien verbundenen Zustand befindet. Wenn ein Netzwerkkabel für ein kabelgebundenes Netzwerk nicht angeschlossen ist, wird dies festgelegt. Bei einem Drahtlosnetzwerk wird dies für den Netzwerkadapter festgelegt, der nicht mit einem Netzwerk verbunden ist.
InterfaceAndOperStatusFlags.Paused
Typ: BOOLEAN Legen Sie fest, ob sich der Netzwerkstapel für die Netzwerkschnittstelle im angehaltenen oder angehaltenen Zustand befindet. Dies bedeutet nicht, dass sich der Computer in einem Ruhezustand befindet.
InterfaceAndOperStatusFlags.LowPower
Typ: BOOLEAN Legen Sie fest, ob sich die Netzwerkschnittstelle in einem Energiesparmodus befindet.
InterfaceAndOperStatusFlags.EndPointInterface
Typ: BOOLEAN Legen Sie fest, ob die Netzwerkschnittstelle ein Endpunktgerät und keine echte Netzwerkschnittstelle ist, die eine Verbindung mit einem Netzwerk herstellt. Dies kann von Geräten wie Smartphones festgelegt werden, die die Netzwerkinfrastruktur für die Kommunikation mit dem PC verwenden, aber keine Konnektivität mit einem externen Netzwerk bereitstellen. Für diese Gerätetypen ist es obligatorisch, dieses Flag festzulegen.
OperStatus
Typ: IF_OPER_STATUS
Der betriebsbereite status für die Schnittstelle, wie in RFC 2863 als IfOperStatus definiert. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2863.txt. Dieser Member kann einer der Werte aus dem IF_OPER_STATUS Enumerationstyp sein, der in der Headerdatei Ifdef.h definiert ist.
AdminStatus
Typ: NET_IF_ADMIN_STATUS
Der administrative status für die Schnittstelle, wie in RFC 2863 definiert. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2863.txt. Dieser Member kann einer der Werte aus dem NET_IF_ADMIN_STATUS Enumerationstyp sein, der in der Headerdatei Ifdef.h definiert ist.
MediaConnectState
Typ: NET_IF_MEDIA_CONNECT_STATE
Der Verbindungsstatus der Schnittstelle. Dieser Member kann einer der Werte aus dem NET_IF_MEDIA_CONNECT_STATE Enumerationstyp sein, der in der Headerdatei Ifdef.h definiert ist.
NetworkGuid
Typ: NET_IF_NETWORK_GUID
Die GUID, die dem Netzwerk zugeordnet ist, zu dem die Schnittstelle gehört.
ConnectionType
Typ: NET_IF_CONNECTION_TYPE
Der NDIS-Netzwerkschnittstellenverbindungstyp. Dieser Member kann einer der Werte aus dem NET_IF_CONNECTION_TYPE Enumerationstyp sein, der in der Headerdatei Ifdef.h definiert ist.
TransmitLinkSpeed
Typ: ULONG64
Die Geschwindigkeit der Übertragungsverbindung in Bits pro Sekunde.
ReceiveLinkSpeed
Typ: ULONG64
Die Geschwindigkeit des Empfangslinks in Bits pro Sekunde.
InOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler über diese Schnittstelle empfangen werden. Dieser Wert umfasst Oktette in Unicast-, Broadcast- und Multicastpaketen.
InUcastPkts
Typ: ULONG64
Die Anzahl der Unicastpakete, die ohne Fehler über diese Schnittstelle empfangen werden.
InNUcastPkts
Typ: ULONG64
Die Anzahl der Nicht-Unicastpakete, die ohne Fehler über diese Schnittstelle empfangen werden. Dieser Wert umfasst Broadcast- und Multicastpakete.
InDiscards
Typ: ULONG64
Die Anzahl der eingehenden Pakete, die verworfen wurden, obwohl keine Fehler erkannt wurden, um zu verhindern, dass die Pakete an ein Protokoll mit höherer Ebene übermittelt werden können.
InErrors
Typ: ULONG64
Die Anzahl der eingehenden Pakete, die aufgrund von Fehlern verworfen wurden.
InUnknownProtos
Typ: ULONG64
Die Anzahl der eingehenden Pakete, die verworfen wurden, weil das Protokoll unbekannt war.
InUcastOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler in Unicastpaketen über diese Schnittstelle empfangen werden.
InMulticastOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler in Multicastpaketen über diese Schnittstelle empfangen werden.
InBroadcastOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler in Broadcastpaketen über diese Schnittstelle empfangen werden.
OutOctets
Typ: ULONG64
Die Anzahl der Oktette der Daten, die ohne Fehler über diese Schnittstelle übertragen werden. Dieser Wert umfasst Oktette in Unicast-, Broadcast- und Multicastpaketen.
OutUcastPkts
Typ: ULONG64
Die Anzahl der Unicastpakete, die ohne Fehler über diese Schnittstelle übertragen werden.
OutNUcastPkts
Typ: ULONG64
Die Anzahl der Nicht-Unicastpakete, die ohne Fehler über diese Schnittstelle übertragen werden. Dieser Wert umfasst Broadcast- und Multicastpakete.
OutDiscards
Typ: ULONG64
Die Anzahl der ausgehenden Pakete, die verworfen wurden, obwohl keine Fehler aufgetreten sind.
OutErrors
Typ: ULONG64
Die Anzahl der ausgehenden Pakete, die aufgrund von Fehlern verworfen wurden.
OutUcastOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler in Unicastpaketen über diese Schnittstelle übertragen werden.
OutMulticastOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler in Multicastpaketen über diese Schnittstelle übertragen werden.
OutBroadcastOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler in Broadcastpaketen über diese Schnittstelle übertragen werden.
OutQLen
Typ: ULONG64
Die Länge der Übertragungswarteschlange. Dieses Feld wird derzeit nicht verwendet.
Hinweise
Die MIB_IF_ROW2-Struktur wird unter Windows Vista und höher definiert.
Die Werte für das Feld Typ werden in der Headerdatei Ipifcons.h definiert. Derzeit werden nur die in der Beschreibung des Typmembers aufgeführten möglichen Werte unterstützt.
Beachten Sie, dass die Netioapi.h-Headerdatei automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Netioapi.h-Headerdatei sollte niemals direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | netioapi.h (include Iphlpapi.h) |