Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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;
Elemente
InterfaceLuid
Typ: NET_LUID
Die lokal eindeutige ID (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 nicht als persistent betrachtet werden sollte.
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-Element 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 Größe der Übertragungseinheit (MTU) in Bytes für diese Netzwerkschnittstelle.
Type
Typ: WENNTYPE
Der Schnittstellentyp gemäß Definition der Internet Assigned Names Authority (IANA). 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 in der Headerdatei "Ifdef.h" definierten TUNNEL_TYPE Enumerationstyp sein.
MediaType
Typ: NDIS_MEDIUM
Der NDIS-Medientyp für die Schnittstelle. Dieses Element kann eines der Werte aus dem in der Ntddndis.h-Headerdatei definierten NDIS_MEDIUM Enumerationstyp sein.
PhysicalMediumType
Typ: NDIS_PHYSICAL_MEDIUM
Der physische NDIS-Mitteltyp. Dieses Element kann einer der Werte aus dem in der Ntddndis.h-Headerdatei definierten NDIS_PHYSICAL_MEDIUM Enumerationstyp sein.
AccessType
Typ: NET_IF_ACCESS_TYPE
Der Schnittstellenzugriffstyp. Dieses Element kann einer der Werte aus dem in der Headerdatei "Ifdef.h" definierten NET_IF_ACCESS_TYPE Enumerationstyp sein.
DirectionType
Typ: NET_IF_DIRECTION_TYPE
Der Schnittstellenrichtungstyp. Dieses Element kann einer der Werte aus dem in der Headerdatei "Ifdef.h" definierten NET_IF_DIRECTION_TYPE Enumerationstyp sein.
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 Null festgelegt.
InterfaceAndOperStatusFlags.HardwareInterface
Typ: BOOLEAN
Legen Sie fest, ob die Netzwerkschnittstelle für Hardware vorgesehen ist.
InterfaceAndOperStatusFlags.FilterInterface
Typ: BOOLEAN
Legen Sie fest, ob sich die Netzwerkschnittstelle für ein Filtermodul befindet.
InterfaceAndOperStatusFlags.ConnectorPresent
Typ: BOOLEAN
Legen Sie fest, ob ein Verbinder 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. Dies gilt zwar sowohl für kabelgebundene als auch für drahtlose Netzwerkverbindungen, die Authentifizierung ist jedoch für Drahtlosnetzwerkverbindungen häufiger.
InterfaceAndOperStatusFlags.NotMediaConnected
Typ: BOOLEAN
Legen Sie fest, ob sich die Netzwerkschnittstelle nicht in einem mediengebundenen 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 im 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 es sich bei der Netzwerkschnittstelle um ein Endpunktgerät und nicht um eine echte Netzwerkschnittstelle handelt, die eine Verbindung mit einem Netzwerk herstellt. Dies kann von Geräten wie Smartphones festgelegt werden, die Netzwerkinfrastruktur für die Kommunikation mit dem PC verwenden, aber keine Verbindung mit einem externen Netzwerk bereitstellen. Für diese Gerätetypen ist es obligatorisch, dieses Kennzeichen festzulegen.
OperStatus
Typ: IF_OPER_STATUS
Der Betriebsstatus für die Schnittstelle, wie in RFC 2863 definiert als IfOperStatus. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2863.txt. Dieses Element kann einer der Werte aus dem in der Headerdatei "Ifdef.h" definierten IF_OPER_STATUS Enumerationstyp sein.
AdminStatus
Typ: NET_IF_ADMIN_STATUS
Der administrative Status für die Schnittstelle gemäß RFC 2863. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc2863.txt. Dieses Element kann einer der Werte aus dem in der Headerdatei "Ifdef.h" definierten NET_IF_ADMIN_STATUS Enumerationstyp sein.
MediaConnectState
Typ: NET_IF_MEDIA_CONNECT_STATE
Der Verbindungsstatus der Schnittstelle. Dieses Element kann einer der Werte aus dem in der Headerdatei "Ifdef.h" definierten NET_IF_MEDIA_CONNECT_STATE Enumerationstyp sein.
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. Dieses Element kann einer der Werte aus dem in der Headerdatei "Ifdef.h" definierten NET_IF_CONNECTION_TYPE Enumerationstyp sein.
TransmitLinkSpeed
Typ: ULONG64
Die Geschwindigkeit in Bits pro Sekunde der Übertragungsverbindung.
ReceiveLinkSpeed
Typ: ULONG64
Die Geschwindigkeit in Bits pro Sekunde des Empfangslinks.
InOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler über diese Schnittstelle empfangen wurden. Dieser Wert umfasst Oktette in Unicast-, Übertragungs- und Multicastpaketen.
InUcastPkts
Typ: ULONG64
Die Anzahl der unicast-Pakete, die ohne Fehler über diese Schnittstelle empfangen wurden.
InNUcastPkts
Typ: ULONG64
Die Anzahl der nicht unicast-Pakete, die ohne Fehler über diese Schnittstelle empfangen wurden. 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 in ein Protokoll mit höherer Ebene geliefert 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 der empfangenen Daten ohne Fehler in Unicast-Paketen über diese Schnittstelle.
InMulticastOctets
Typ: ULONG64
Die Anzahl der Oktette der empfangenen Daten ohne Fehler in Multicastpaketen über diese Schnittstelle.
InBroadcastOctets
Typ: ULONG64
Die Anzahl der Oktette der empfangenen Daten ohne Fehler in Übertragungspaketen über diese Schnittstelle.
OutOctets
Typ: ULONG64
Die Anzahl der Oktette von Daten, die ohne Fehler über diese Schnittstelle übertragen werden. Dieser Wert umfasst Oktette in Unicast-, Übertragungs- und Multicastpaketen.
OutUcastPkts
Typ: ULONG64
Die Anzahl der unicast-Pakete, die ohne Fehler über diese Schnittstelle übertragen werden.
OutNUcastPkts
Typ: ULONG64
Die Anzahl der nicht unicast-Pakete, 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 sie keine Fehler hatten.
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 Unicast-Paketen ü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 Übertragungspaketen über diese Schnittstelle übertragen werden.
OutQLen
Typ: ULONG64
Die Länge der Übertragungswarteschlange. Dieses Feld wird derzeit nicht verwendet.
Bemerkungen
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 möglichen Werte unterstützt, die in der Beschreibung des Typelements aufgeführt sind.
Beachten Sie, dass die Headerdatei "Netioapi.h " automatisch in der Headerdatei "Iphlpapi.h " enthalten ist. Die Headerdatei Netioapi.h sollte nie direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows Vista [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2008 [Nur Desktop-Apps] |
| Header | netioapi.h (include Iphlpapi.h) |