MIB_TCPROW_W2K-Struktur (tcpmib.h)
Die MIB_TCPROW-Struktur enthält Informationen, die eine IPv4-TCP-Verbindung descibe.
Syntax
typedef struct _MIB_TCPROW_W2K {
DWORD dwState;
DWORD dwLocalAddr;
DWORD dwLocalPort;
DWORD dwRemoteAddr;
DWORD dwRemotePort;
} MIB_TCPROW_W2K, *PMIB_TCPROW_W2K;
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 Windows SDK für Windows Vista und höher veröffentlicht, wurde 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 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.
dwLocalAddr
Art: DWORD
Die lokale IPv4-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.
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.
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.
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.
Hinweise
Die GetTcpTable-Funktion ruft die IPv4-TCP-Verbindungstabelle auf dem lokalen Computer ab und gibt diese Informationen in einer MIB_TCPTABLE-Struktur zurück.
Ein Array von MIB_TCPROW Strukturen ist in der MIB_TCPTABLE-Struktur enthalten. Die MIB_TCPROW-Struktur wird auch von der SetTcpEntry-Funktion verwendet.
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 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 Elementen dwLocalAddr oder dwRemoteAddr in eine Zeichenfolge zu konvertieren, ohne die Windows Sockets-DLL zu laden.
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 MIB_TCPROW-Struktur hat sich unter Windows Vista und höher geringfügig geändert. Unter Windows Vista und höher wird der dwState-Member durch eine Union ersetzt, die die folgenden Elemente enthält.
Im Windows SDK wird die Version der Struktur für die Verwendung unter Windows Vista und höher als MIB_TCPROW_LH definiert. Im Windows SDK wird die Version dieser Struktur, die auf früheren Systemen verwendet werden soll, einschließlich Windows 2000 und höher, als MIB_TCPROW_W2K definiert. Beim Kompilieren einer Anwendung, wenn die Zielplattform Windows Vista und höher (NTDDI_VERSION >= NTDDI_LONGHORN, oder WINVER >= 0x0600) ist, _WIN32_WINNT >= 0x0600wird die MIB_TCPROW_LH-Struktur in die MIB_TCPROW-Struktur eingegeben. Wenn eine Anwendung kompiliert wird, wenn die Zielplattform nicht Windows Vista und höher ist, wird die MIB_TCPROW_W2K-Struktur in die MIB_TCPROW-Struktur eingegeben.
Auf der Windows SDK für Windows Vista und höher veröffentlicht, wurde die organization der 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 niemals direkt verwendet werden.
Beispiele
Im folgenden Beispiel wird die TCP-Verbindungstabelle abgerufen und der Status jeder Verbindung ausgegeben, die als MIB_TCPROW-Struktur dargestellt wird.
#include <winsock2.h>
#include <ws2tcpip.h>
#include <iphlpapi.h>
#include <stdio.h>
// Need to link with Iphlpapi.lib and Ws2_32.lib
#pragma comment(lib, "iphlpapi.lib")
#pragma comment(lib, "ws2_32.lib")
#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))
/* Note: could also use malloc() and free() */
int main()
{
// Declare and initialize variables
PMIB_TCPTABLE pTcpTable;
DWORD dwSize = 0;
DWORD dwRetVal = 0;
char szLocalAddr[128];
char szRemoteAddr[128];
struct in_addr IpAddr;
int i;
pTcpTable = (MIB_TCPTABLE *) MALLOC(sizeof (MIB_TCPTABLE));
if (pTcpTable == NULL) {
printf("Error allocating memory\n");
return 1;
}
dwSize = sizeof (MIB_TCPTABLE);
// Make an initial call to GetTcpTable to
// get the necessary size into the dwSize variable
if ((dwRetVal = GetTcpTable(pTcpTable, &dwSize, TRUE)) ==
ERROR_INSUFFICIENT_BUFFER) {
FREE(pTcpTable);
pTcpTable = (MIB_TCPTABLE *) MALLOC(dwSize);
if (pTcpTable == NULL) {
printf("Error allocating memory\n");
return 1;
}
}
// Make a second call to GetTcpTable to get
// the actual data we require
if ((dwRetVal = GetTcpTable(pTcpTable, &dwSize, TRUE)) == NO_ERROR) {
printf("\tNumber of entries: %d\n", (int) pTcpTable->dwNumEntries);
for (i = 0; i < (int) pTcpTable->dwNumEntries; i++) {
printf("\n\tTCP[%d] State: %ld - ", i,
pTcpTable->table[i].dwState);
switch (pTcpTable->table[i].dwState) {
case MIB_TCP_STATE_CLOSED:
printf("CLOSED\n");
break;
case MIB_TCP_STATE_LISTEN:
printf("LISTEN\n");
break;
case MIB_TCP_STATE_SYN_SENT:
printf("SYN-SENT\n");
break;
case MIB_TCP_STATE_SYN_RCVD:
printf("SYN-RECEIVED\n");
break;
case MIB_TCP_STATE_ESTAB:
printf("ESTABLISHED\n");
break;
case MIB_TCP_STATE_FIN_WAIT1:
printf("FIN-WAIT-1\n");
break;
case MIB_TCP_STATE_FIN_WAIT2:
printf("FIN-WAIT-2 \n");
break;
case MIB_TCP_STATE_CLOSE_WAIT:
printf("CLOSE-WAIT\n");
break;
case MIB_TCP_STATE_CLOSING:
printf("CLOSING\n");
break;
case MIB_TCP_STATE_LAST_ACK:
printf("LAST-ACK\n");
break;
case MIB_TCP_STATE_TIME_WAIT:
printf("TIME-WAIT\n");
break;
case MIB_TCP_STATE_DELETE_TCB:
printf("DELETE-TCB\n");
break;
default:
printf("UNKNOWN dwState value: %d\n", pTcpTable->table[i].dwState);
break;
}
IpAddr.S_un.S_addr = (u_long) pTcpTable->table[i].dwLocalAddr;
strcpy_s(szLocalAddr, sizeof (szLocalAddr), inet_ntoa(IpAddr));
printf("\tTCP[%d] Local Addr: %s\n", i, szLocalAddr);
printf("\tTCP[%d] Local Port: %d \n", i,
ntohs((u_short)pTcpTable->table[i].dwLocalPort));
IpAddr.S_un.S_addr = (u_long) pTcpTable->table[i].dwRemoteAddr;
strcpy_s(szRemoteAddr, sizeof (szRemoteAddr), inet_ntoa(IpAddr));
printf("\tTCP[%d] Remote Addr: %s\n", i, szRemoteAddr);
printf("\tTCP[%d] Remote Port: %d\n", i,
ntohs((u_short)pTcpTable->table[i].dwRemotePort));
}
} else {
printf("\tGetTcpTable failed with %d\n", dwRetVal);
FREE(pTcpTable);
return 1;
}
if (pTcpTable != NULL) {
FREE(pTcpTable);
pTcpTable = NULL;
}
return 0;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Kopfzeile | tcpmib.h (include Iphlpapi.h) |
Weitere Informationen
MIB_TCP6ROW2