IP_INTERFACE_NAME_INFO_W2KSP1-Struktur (iptypes.h)

Artikel
03/01/2024

Die IP_INTERFACE_NAME_INFO-Struktur enthält Informationen zu einer IPv4-Schnittstelle auf dem lokalen Computer.

Syntax

typedef struct ip_interface_name_info_w2ksp1 {
  ULONG Index;
  ULONG MediaType;
  UCHAR ConnectionType;
  UCHAR AccessType;
  GUID  DeviceGuid;
  GUID  InterfaceGuid;
} IP_INTERFACE_NAME_INFO_W2KSP1, *PIP_INTERFACE_NAME_INFO_W2KSP1;

Member

Index

Typ: ULONG

Der Index der IP-Schnittstelle für die aktive instance.

MediaType

Typ: ULONG

Der Von der Internet Assigned Names Authority (IANA) definierte Schnittstellentyp. 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.

Wert	Bedeutung
IF_TYPE_OTHER 1	Eine andere Art von Netzwerkschnittstelle.
IF_TYPE_ETHERNET_CSMACD 6	Eine Ethernet-Netzwerkschnittstelle.
IF_TYPE_ISO88025_TOKENRING 9	Eine Tokenringnetzwerkschnittstelle.
IF_TYPE_PPP 23	Eine PPP-Netzwerkschnittstelle.
IF_TYPE_SOFTWARE_LOOPBACK 24	Eine Software-Loopback-Netzwerkschnittstelle.
IF_TYPE_ATM 37	Eine ATM-Netzwerkschnittstelle.
IF_TYPE_IEEE80211 71	Eine IEEE 802.11-Funknetzwerkschnittstelle. Unter Windows Vista und höher werden Drahtlosnetzwerkkarten als IF_TYPE_IEEE80211 gemeldet. Windows Server 2003, Windows 2000 Server mit SP1 und Windows XP/2000: Drahtlosnetzwerkkarten werden als IF_TYPE_ETHERNET_CSMACD gemeldet.
IF_TYPE_TUNNEL 131	Eine Tunneltyp-Netzwerkschnittstelle.
IF_TYPE_IEEE1394 144	Eine IEEE 1394 (Firewire) Hochleistungs-serielle Busnetzwerkschnittstelle.

ConnectionType

Typ: UCHAR

Der Schnittstellenverbindungstyp für den Adapter.

Die möglichen Werte für dieses Element werden in der Headerdatei Ipifcons.h definiert.

Wert	Bedeutung
IF_CONNECTION_DEDICATED 1	Der Verbindungstyp ist dediziert. Die Verbindung wird automatisch hergestellt, wenn der Mediensinn TRUE ist. Beispielsweise ist eine Ethernet-Verbindung dedizierter.
IF_CONNECTION_PASSIVE 2	Der Verbindungstyp ist passiv. Das Remoteende muss die Verbindung mit der lokalen Station herstellen. Beispielsweise ist eine RAS-Schnittstelle passiv.
IF_CONNECTION_DEMAND 3	Der Verbindungstyp ist die Bedarfswahl. Eine Verbindung dieses Typs wird als Reaktion auf eine lokale Aktion (z. B. das Senden eines Pakets) hergestellt.

AccessType

Typ: UCHAR

Ein Wert der IF_ACCESS_TYPE-Enumeration , der den Zugriffstyp für die Schnittstelle angibt.

Windows Server 2003, Windows 2000 Server mit SP1 und Windows XP/2000: Die möglichen Werte für dieses Element werden in der Headerdatei Ipifcons.h definiert.

Wert	Bedeutung
IF_ACCESS_LOOPBACK 1	Der Loopbackzugriffstyp. Dieser Wert gibt an, dass die Schnittstelle Daten als Empfangsdaten zurückgibt.
IF_ACCESS_BROADCAST 2	Der LAN-Zugriffstyp, der Ethernet umfasst. Dieser Wert gibt an, dass die Schnittstelle native Unterstützung für Multicast- oder Broadcastdienste bietet.
IF_ACCESS_POINT_TO_POINT 3	Der Punkt-zu-Punkt-Zugriffstyp. Dieser Wert gibt die Unterstützung für CoNDIS/WAN an, mit Ausnahme von NBMA-Schnittstellen (Non-Broadcast Multi Access). Windows Server 2003, Windows 2000 Server mit SP1 und Windows XP/2000: Dieser Wert wurde als IF_ACCESS_POINTTOPOINT in der Headerdatei Ipifcons.h definiert.
IF_ACCESS_POINT_TO_MULTI_POINT 4	Der Punkt auf den Mehrpunktzugriffstyp. Dieser Wert gibt die Unterstützung für Nicht-Broadcast-Multizugriffsmedien an, einschließlich der internen RAS-Schnittstelle und des nativen ATM. Windows Server 2003, Windows 2000 Server mit SP1 und Windows XP/2000: Dieser Wert wurde als IF_ACCESS_POINTTOMULTIPOINT in der Headerdatei Ipifcons.h definiert.

DeviceGuid

Typ: GUID

Die GUID, die das zugrunde liegende Gerät für die Schnittstelle identifiziert. Bei diesem Member kann es sich um eine GUID mit Null sein.

InterfaceGuid

Typ: GUID

Die GUID, die die dem Gerät zugeordnete Schnittstelle identifiziert. Optional. Bei diesem Member kann es sich um eine GUID mit Null sein.

Hinweise

Im Microsoft Windows Software Development Kit (SDK) wird die Version der Struktur für die Verwendung unter Windows 2000 mit Service Pack 1 (SP1) und höher als IP_INTERFACE_NAME_INFO_W2KSP1 definiert. Beim Kompilieren einer Anwendung, wenn die Zielplattform Windows 2000 mit SP1 und höher (NTDDI_VERSION >= NTDDI_WIN2KSP1, oderWINVER >= 0x0500) ist, _WIN32_WINNT >= 0x0500wird die IP_INTERFACE_NAME_INFO_W2KSP1 Struktur in die IP_INTERFACE_NAME_INFO-Struktur eingegeben.

Die MediaType-, ConnectionType- und AccessType-Member , Definitionen und zugewiesenen Werte sind in der Headerdatei Ipifcons.h verfügbar.

Der optionale InterfaceGuid-Member ist häufig für DFÜ-Schnittstellen festgelegt und kann verwendet werden, um mehrere DFÜ-Schnittstellen zu unterscheiden, die dieselbe Geräte-GUID verwenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP1 [nur Desktop-Apps]
Kopfzeile	iptypes.h (include Iphlpapi.h)

Weitere Informationen

GetAdaptersAddresses

NhpAllocateAndGetInterfaceInfoFromStack

Share via