MIB_TCP6ROW2-Struktur (tcpmib.h)
Die MIB_TCP6ROW2-Struktur enthält Informationen, die eine IPv6-TCP-Verbindung beschreiben.
Syntax
typedef struct _MIB_TCP6ROW2 {
IN6_ADDR LocalAddr;
DWORD dwLocalScopeId;
DWORD dwLocalPort;
IN6_ADDR RemoteAddr;
DWORD dwRemoteScopeId;
DWORD dwRemotePort;
MIB_TCP_STATE State;
DWORD dwOwningPid;
TCP_CONNECTION_OFFLOAD_STATE dwOffloadState;
} MIB_TCP6ROW2, *PMIB_TCP6ROW2;
Member
LocalAddr
Typ: IN6_ADDR
Die lokale IPv6-Adresse für die TCP-Verbindung auf dem lokalen Computer. Der Wert 0 gibt an, dass der Listener eine Verbindung auf einer beliebigen Schnittstelle akzeptieren kann.
dwLocalScopeId
Art: DWORD
Die lokale Bereichs-ID für die TCP-Verbindung auf dem lokalen Computer.
dwLocalPort
Art: DWORD
Die lokale Portnummer in Netzwerkbytereihenfolge für die TCP-Verbindung auf dem lokalen Computer.
Die maximale Größe einer IP-Portnummer beträgt 16 Bit, daher sollten nur die unteren 16 Bits verwendet werden. Die oberen 16 Bits können nicht initialisierte Daten enthalten.
RemoteAddr
Typ: IN6_ADDR
Die IPv6-Adresse für die TCP-Verbindung auf dem Remotecomputer. Wenn das Mitglied des StaatesMIB_TCP_STATE_LISTEN ist, hat dieser Wert keine Bedeutung.
dwRemoteScopeId
Art: DWORD
Die Remotebereichs-ID für die TCP-Verbindung auf dem Remotecomputer. Wenn das Mitglied des StaatesMIB_TCP_STATE_LISTEN ist, hat dieser Wert keine Bedeutung.
dwRemotePort
Art: DWORD
Die Remoteportnummer in Netzwerkbytereihenfolge für die TCP-Verbindung auf dem Remotecomputer. Wenn das Mitglied des StaatesMIB_TCP_STATE_LISTEN ist, hat dieser Wert keine Bedeutung.
Die maximale Größe einer IP-Portnummer beträgt 16 Bit, daher sollten nur die unteren 16 Bits verwendet werden. Die oberen 16 Bits können nicht initialisierte Daten enthalten.
State
Typ: MIB_TCP_STATE
Der Status der TCP-Verbindung. Dieser Member kann einer der Werte aus dem MIB_TCP_STATE Enumerationstyp sein, der in der Headerdatei "Tcpmib.h " definiert ist.
dwOwningPid
Art: DWORD
Die PID des Prozesses, der eine Kontextbindung für diese TCP-Verbindung ausgestellt hat.
dwOffloadState
Typ: TCP_CONNECTION_OFFLOAD_STATE
Der Auslagerungsstatus für diese TCP-Verbindung. Dieser Parameter kann einer der Enumerationswerte für den im Tcpmib.h-Header definierten TCP_CONNECTION_OFFLOAD_STATE sein.
Hinweise
Die MIB_TCP6ROW2-Struktur wird unter Windows Vista und höher definiert.
Die GetTcp6Table2-Funktion ruft die IPv6 TCP-Verbindungstabelle auf dem lokalen Computer ab und gibt diese Informationen in einer MIB_TCP6TABLE2-Struktur zurück.
Ein Array von MIB_TCP6ROW2 Strukturen ist in der MIB_TCP6TABLE2-Struktur enthalten.
Das State-Element gibt den Status des TCP-Eintrags in einem TCP-Zustandsdiagramm an. Eine TCP-Verbindung durchläuft während ihrer Lebensdauer eine Reihe von Zuständen. Die Zustände sind: LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSING, LAST-ACK, TIME-WAIT und der fiktive Status GESCHLOSSEN. Der ZUSTAND CLOSED ist fiktional, da er den Zustand darstellt, wenn kein Übertragungssteuerungsblock und daher keine Verbindung vorhanden ist. Das TCP-Protokoll wird in RFC 793 beschrieben. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc793.txt.
Die Mitglieder dwLocalPort und dwRemotePort befinden sich in der Reihenfolge des Netzwerkbytes. Um die dwLocalPort - oder dwRemotePort-Member verwenden zu können, sind möglicherweise die Funktionen ntohs oder inet_ntoa in Windows Sockets oder ähnlichen Funktionen erforderlich.
Die Mitglieder dwLocalScopeId und dwRemoteScopeId befinden sich in der Reihenfolge des Netzwerkbytes. Um die dwLocalScopeId - oder dwRemoteScopeId-Member verwenden zu können, sind möglicherweise die Funktionen ntohl oder inet_ntoa in Windows Sockets oder ähnlichen Funktionen erforderlich.
Die Member LocalAddr und RemoteAddr werden in in6_addr-Strukturen gespeichert. Die Funktionen RtlIpv6AddressToString oder RtlIpv6AddressToStringEx können verwendet werden, um die IPv6-Adresse in den LocalAddr- oder RemoteAddr-Membern in eine Zeichenfolge zu konvertieren, ohne die Windows Sockets-DLL zu laden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | tcpmib.h (include Iphlpapi.h) |