MIB_TCP6ROW_OWNER_PID-Struktur (tcpmib.h)

Artikel
08/26/2023

Die MIB_TCP6ROW_OWNER_PID-Struktur enthält Informationen, die eine IPv6-TCP-Verbindung beschreiben, die einer bestimmten Prozess-ID (PID) zugeordnet ist.

Syntax

typedef struct _MIB_TCP6ROW_OWNER_PID {
  UCHAR ucLocalAddr[16];
  DWORD dwLocalScopeId;
  DWORD dwLocalPort;
  UCHAR ucRemoteAddr[16];
  DWORD dwRemoteScopeId;
  DWORD dwRemotePort;
  DWORD dwState;
  DWORD dwOwningPid;
} MIB_TCP6ROW_OWNER_PID, *PMIB_TCP6ROW_OWNER_PID;

Member

ucLocalAddr[16]

Typ: UCHAR[16]

Die IPv6-Adresse für den lokalen Endpunkt der 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 Bereichs-ID in Netzwerkbytereihenfolge für die lokale IPv6-Adresse.

dwLocalPort

Art: DWORD

Die Portnummer in Netzwerkbytereihenfolge für den lokalen Endpunkt der TCP-Verbindung auf dem lokalen Computer.

ucRemoteAddr[16]

Typ: UCHAR[16]

Die IPv6-Adresse des Remoteendpunkts der TCP-Verbindung auf dem Remotecomputer. Wenn der dwState-MemberMIB_TCP_STATE_LISTEN ist, hat dieser Wert keine Bedeutung.

dwRemoteScopeId

Art: DWORD

Die Bereichs-ID in Netzwerkbytereihenfolge für die IPv6-Remoteadresse.

dwRemotePort

Art: DWORD

Die Portnummer in Netzwerkbytereihenfolge für den Remoteendpunkt der TCP-Verbindung auf dem Remotecomputer.

dwState

Art: DWORD

Der Status der TCP-Verbindung. Dieses Element kann einer der Werte aus der MIB_TCP_STATE Enumeration sein, die in der Headerdatei "Tcpmib.h " definiert ist. Beachten Sie, dass die Tcpmib.h-Headerdatei automatisch in Iprtrmib.h enthalten ist, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Headerdateien Tcpmib.h und Iprtrmib.h sollten nie direkt verwendet werden.

Wert	Bedeutung
MIB_TCP_STATE_CLOSED 1	Die TCP-Verbindung befindet sich im Zustand CLOSED, der überhaupt keinen Verbindungszustand darstellt.
MIB_TCP_STATE_LISTEN 2	Die TCP-Verbindung befindet sich im LISTEN-Zustand und wartet auf eine Verbindungsanforderung von einem beliebigen Remote-TCP und -Port.
MIB_TCP_STATE_SYN_SENT 3	Die TCP-Verbindung befindet sich im SYN-SENT-Zustand und wartet auf eine übereinstimmende Verbindungsanforderung, nachdem eine Verbindungsanforderung (SYN-Paket) gesendet wurde.
MIB_TCP_STATE_SYN_RCVD 4	Die TCP-Verbindung befindet sich im ZUSTAND SYN-RECEIVED und wartet auf eine Bestätigung der Verbindungsanforderung, nachdem eine Verbindungsanforderung (SYN-Paket) empfangen und gesendet wurde.
MIB_TCP_STATE_ESTAB 5	Die TCP-Verbindung befindet sich im ZUSTAND ESTABLISHED, der eine offene Verbindung darstellt. Empfangene Daten können an den Benutzer übermittelt werden. Dies ist der Normalzustand für die Datenübertragungsphase der TCP-Verbindung.
MIB_TCP_STATE_FIN_WAIT1 6	Bei der TCP-Verbindung handelt es sich um einen FIN-WAIT-1-Zustand, der auf eine Verbindungsabschlussanforderung vom Remote-TCP oder eine Bestätigung der zuvor gesendeten Verbindungsabschlussanforderung wartet.
MIB_TCP_STATE_FIN_WAIT2 7	Die TCP-Verbindung ist FIN-WAIT-1-Zustand, der auf eine Verbindungsabschlussanforderung vom Remote-TCP wartet.
MIB_TCP_STATE_CLOSE_WAIT 8	Die TCP-Verbindung befindet sich im Zustand CLOSE-WAIT und wartet auf eine Verbindungsabbruchanforderung des lokalen Benutzers.
MIB_TCP_STATE_CLOSING 9	Die TCP-Verbindung befindet sich im Status CLOSING und wartet auf eine Bestätigung der Verbindungsabbruchanforderung vom Remote-TCP.
MIB_TCP_STATE_LAST_ACK 10	Die TCP-Verbindung befindet sich im Status LAST-ACK und wartet auf eine Bestätigung der Verbindungsabschlussanforderung, die zuvor an den Remote-TCP gesendet wurde (einschließlich einer Bestätigung der Verbindungsabschlussanforderung).
MIB_TCP_STATE_TIME_WAIT 11	Die TCP-Verbindung befindet sich im ZUSTAND TIME-WAIT und wartet darauf, dass genügend Zeit verstreichen kann, um sicherzustellen, dass das Remote-TCP die Bestätigung seiner Verbindungsabbruchanforderung erhalten hat.
MIB_TCP_STATE_DELETE_TCB 12	Die TCP-Verbindung befindet sich im TCB-Zustand delete, der das Löschen des Transmission Control Block (TCB) darstellt, einer Datenstruktur, die zum Verwalten von Informationen zu den einzelnen TCP-Einträgen verwendet wird.

dwOwningPid

Art: DWORD

Die PID des lokalen Prozesses, der eine Kontextbindung für diese TCP-Verbindung ausgestellt hat.

Hinweise

Die MIB_TCP6TABLE_OWNER_PID-Struktur wird durch einen Aufruf von GetExtendedTcpTable zurückgegeben, wobei der TableClass-Parameter auf TCP_TABLE_OWNER_PID_LISTENER, TCP_TABLE_OWNER_PID_CONNECTIONS oder TCP_TABLE_OWNER_PID_ALL aus der TCP_TABLE_CLASS-Enumeration festgelegt ist und der ulAf-Parameter auf AF_INET6 festgelegt ist. Die MIB_TCP6TABLE_OWNER_PID-Struktur enthält ein Array von MIB_TCP6ROW_OWNER_PID Strukturen.

Das dwState-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 Elemente ucLocalAddr und ucRemoteAddr werden in einem Zeichenarray in Netzwerkbytereihenfolge gespeichert. Die Funktionen RtlIpv6AddressToString oder RtlIpv6AddressToStringEx können verwendet werden, um die IPv6-Adresse in den Elementen ucLocalAddr oder ucRemoteAddr in eine Zeichenfolge zu konvertieren, ohne die Windows Sockets-DLL zu laden.

Im Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, hat sich die organization von Headerdateien geändert. Diese Struktur wird in der Headerdatei "Tcpmib.h " definiert, nicht in der Headerdatei "Iprtrmib.h ". Beachten Sie, dass die Tcpmib.h-Headerdatei automatisch in Iprtrmib.h enthalten ist, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Headerdateien Tcpmib.h und Iprtrmib.h sollten nie direkt verwendet werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps]
Kopfzeile	tcpmib.h (include Iphlpapi.h)