MIB_TCP6ROW_OWNER_PID-Struktur (tcpmib.h)
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.
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) |