MIB_TCPROW_OWNER_PID-Struktur (tcpmib.h)

Artikel
08/26/2023

Die MIB_TCPROW_OWNER_PID-Struktur enthält Informationen, die eine IPv4-TCP-Verbindung mit IPv4-Adressen, von der TCP-Verbindung verwendete Ports und die spezifische Prozess-ID (PID) beschreiben, die der Verbindung zugeordnet ist.

Syntax

typedef struct _MIB_TCPROW_OWNER_PID {
  DWORD dwState;
  DWORD dwLocalAddr;
  DWORD dwLocalPort;
  DWORD dwRemoteAddr;
  DWORD dwRemotePort;
  DWORD dwOwningPid;
} MIB_TCPROW_OWNER_PID, *PMIB_TCPROW_OWNER_PID;

Member

dwState

Art: DWORD

Der Status der TCP-Verbindung. Dieser Member kann einer der Werte sein, die in der Headerdatei Iprtrmib.h definiert sind.

Auf der für Windows Vista und höher veröffentlichten Windows SDK hat sich die organization der Headerdateien geändert. Dieser Member kann einer der Werte aus der MIB_TCP_STATE-Enumeration sein, die in der Headerdatei "Tcpmib.h " und nicht in der Headerdatei "Iprtrmib.h " definiert ist. Beachten Sie, dass die Headerdatei Tcpmib.h automatisch in Iprtrmib.h enthalten ist, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Headerdateien Tcpmib.h und Iprtrmib.h sollten niemals 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 ZUSTAND SYN-SENT und wartet auf eine übereinstimmende Verbindungsanforderung, nachdem sie eine Verbindungsanforderung (SYN-Paket) gesendet hat.
MIB_TCP_STATE_SYN_RCVD 4	Die TCP-Verbindung befindet sich im STATUS SYN-RECEIVED und wartet auf eine bestätigungsfähige Bestätigung der Verbindungsanforderung, nachdem sie eine Verbindungsanforderung (SYN-Paket) empfangen und gesendet hat.
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 normale Zustand für die Datenübertragungsphase der TCP-Verbindung.
MIB_TCP_STATE_FIN_WAIT1 6	Bei der TCP-Verbindung handelt es sich um den Status FIN-WAIT-1, der auf eine Verbindungsabschlussanforderung vom Remote-TCP oder auf eine Bestätigung der zuvor gesendeten Verbindungsabschlussanforderung wartet.
MIB_TCP_STATE_FIN_WAIT2 7	Die TCP-Verbindung ist der Status FIN-WAIT-2, der auf eine Verbindungsabschlussanforderung vom Remote-TCP wartet.
MIB_TCP_STATE_CLOSE_WAIT 8	Die TCP-Verbindung befindet sich im CLOSE-WAIT-Zustand und wartet auf eine Verbindungsabschlussanforderung vom lokalen Benutzer.
MIB_TCP_STATE_CLOSING 9	Die TCP-Verbindung befindet sich im Zustand CLOSING und wartet auf eine Bestätigung der Verbindungsabschlussanforderung 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 das Remote-TCP gesendet wurde (einschließlich einer Bestätigung der Verbindungsbeendigungsanforderung).
MIB_TCP_STATE_TIME_WAIT 11	Die TCP-Verbindung befindet sich im Status TIME-WAIT und wartet auf genügend Zeit, um sicherzustellen, dass das Remote-TCP die Bestätigung seiner Verbindungsabschlussanforderung erhalten hat.
MIB_TCP_STATE_DELETE_TCB 12	Die TCP-Verbindung befindet sich im TCB-Löschzustand, der das Löschen des Transmission Control Blocks (TCB) darstellt, einer Datenstruktur, die zum Verwalten von Informationen zu jedem TCP-Eintrag verwendet wird.

dwLocalAddr

Art: DWORD

Die lokale IPv4-Adresse für die TCP-Verbindung auf dem lokalen Computer. Der Wert 0 (null) gibt an, dass der Listener eine Verbindung für eine beliebige Schnittstelle akzeptieren kann.

dwLocalPort

Art: DWORD

Die lokale Portnummer in Netzwerkbytereihenfolge für die TCP-Verbindung auf dem lokalen Computer.

dwRemoteAddr

Art: DWORD

Die IPv4-Adresse für die TCP-Verbindung auf dem Remotecomputer. Wenn der dwState-MemberMIB_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 dwState-ElementMIB_TCP_STATE_LISTEN ist, hat dieses Element keine Bedeutung.

dwOwningPid

Art: DWORD

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

Hinweise

Die MIB_TCPROW_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_INET4 festgelegt ist.

Der dwState-Member 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 Status sind: LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSING, LAST-ACK, TIME-WAIT und der fiktive Zustand CLOSED. Der CLOSED-Zustand ist fiktiv, da er den Zustand darstellt, wenn kein Übertragungskontrollblock 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 Netzwerkbytereihenfolge. 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 Elemente dwLocalAddr und dwRemoteAddr werden als DWORD im gleichen Format wie die in_addr-Struktur gespeichert. Um die DwLocalAddr - oder dwRemoteAddr-Member verwenden zu können, sind möglicherweise die Funktionen ntohl oder inet_ntoa in Windows Sockets oder ähnlichen Funktionen erforderlich. Unter Windows Vista und höher können die Funktionen RtlIpv4AddressToString oder RtlIpv4AddressToStringEx verwendet werden, um die IPv4-Adresse in den Membern dwLocalAddr oder dwRemoteAddr in eine Zeichenfolge zu konvertieren, ohne die Windows Sockets-DLL zu laden.

Auf der für Windows Vista und höher veröffentlichten Windows SDK hat sich die organization der Headerdateien geändert. Diese Struktur wird in der Headerdatei Tcpmib.h und nicht in der Headerdatei Iprtrmib.h definiert. Beachten Sie, dass die Headerdatei Tcpmib.h automatisch in Iprtrmib.h enthalten ist, die automatisch in der Headerdatei Iphlpapi.h enthalten ist. Die Headerdateien Tcpmib.h und Iprtrmib.h sollten niemals direkt verwendet werden.

Anforderungen

Anforderung	Wert
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)