Condividi tramite


struttura MIB_TCPROW2 (tcpmib.h)

La struttura MIB_TCPROW2 contiene informazioni che descrivono una connessione TCP IPv4.

Sintassi

typedef struct _MIB_TCPROW2 {
  DWORD                        dwState;
  DWORD                        dwLocalAddr;
  DWORD                        dwLocalPort;
  DWORD                        dwRemoteAddr;
  DWORD                        dwRemotePort;
  DWORD                        dwOwningPid;
  TCP_CONNECTION_OFFLOAD_STATE dwOffloadState;
} MIB_TCPROW2, *PMIB_TCPROW2;

Members

dwState

Tipo: DWORD

Stato della connessione TCP. Questo membro può essere uno dei valori definiti nel file di intestazione Iprtrmib.h .

In Windows SDK rilasciato per Windows Vista e versioni successive, l'organizzazione dei file di intestazione è stata modificata. Questo membro può essere uno dei valori dell'enumerazione MIB_TCP_STATE definita nel file di intestazione Tcpmib.h , non nel file di intestazione Iprtrmib.h . Si noti che il file di intestazione Tcpmib.h viene automaticamente incluso in Iprtrmib.h, incluso automaticamente nel file di intestazione Iphlpapi.h . I file di intestazione Tcpmib.h e Iprtrmib.h non devono mai essere usati direttamente.

Valore Significato
MIB_TCP_STATE_CLOSED
1
La connessione TCP si trova nello stato CLOSED che non rappresenta affatto lo stato di connessione.
MIB_TCP_STATE_LISTEN
2
La connessione TCP si trova nello stato LISTEN in attesa di una richiesta di connessione da qualsiasi porta e TCP remoto.
MIB_TCP_STATE_SYN_SENT
3
La connessione TCP si trova nello stato SYN-SENT in attesa di una richiesta di connessione corrispondente dopo aver inviato una richiesta di connessione (pacchetto SYN).
MIB_TCP_STATE_SYN_RCVD
4
La connessione TCP si trova nello stato SYN-RECEIVED in attesa di una conferma del riconoscimento della richiesta di connessione dopo aver ricevuto e inviato una richiesta di connessione (pacchetto SYN).
MIB_TCP_STATE_ESTAB
5
La connessione TCP si trova nello stato ESTABLISHED che rappresenta una connessione aperta, i dati ricevuti possono essere recapitati all'utente. Questo è lo stato normale per la fase di trasferimento dei dati della connessione TCP.
MIB_TCP_STATE_FIN_WAIT1
6
La connessione TCP è in attesa dello stato FIN-WAIT-1 in attesa di una richiesta di terminazione della connessione da TCP remoto o di un riconoscimento della richiesta di terminazione della connessione inviata in precedenza.
MIB_TCP_STATE_FIN_WAIT2
7
La connessione TCP è in attesa dello stato FIN-WAIT-1 per una richiesta di terminazione della connessione da TCP remoto.
MIB_TCP_STATE_CLOSE_WAIT
8
La connessione TCP si trova nello stato CLOSE-WAIT in attesa di una richiesta di terminazione della connessione dall'utente locale.
MIB_TCP_STATE_CLOSING
9
La connessione TCP si trova nello stato CLOSING in attesa del riconoscimento di una richiesta di terminazione della connessione da TCP remoto.
MIB_TCP_STATE_LAST_ACK
10
La connessione TCP si trova nello stato LAST-ACK in attesa di un riconoscimento della richiesta di terminazione della connessione inviata in precedenza al TCP remoto (che include un riconoscimento della richiesta di terminazione della connessione).
MIB_TCP_STATE_TIME_WAIT
11
La connessione TCP si trova nello stato TIME-WAIT in attesa del tempo sufficiente per assicurarsi che il TCP remoto abbia ricevuto il riconoscimento della richiesta di terminazione della connessione.
MIB_TCP_STATE_DELETE_TCB
12
La connessione TCP si trova nello stato di eliminazione TCB che rappresenta l'eliminazione del TCB (Transmission Control Block), una struttura di dati utilizzata per mantenere le informazioni su ogni voce TCP.

dwLocalAddr

Tipo: DWORD

Indirizzo IPv4 locale per la connessione TCP nel computer locale. Il valore zero indica che il listener può accettare una connessione su qualsiasi interfaccia.

dwLocalPort

Tipo: DWORD

Numero di porta locale in ordine di byte di rete per la connessione TCP nel computer locale.

La dimensione massima di un numero di porta IP è di 16 bit, quindi devono essere usati solo i 16 bit inferiori. I 16 bit superiori possono contenere dati non inizializzati.

dwRemoteAddr

Tipo: DWORD

Indirizzo IPv4 per la connessione TCP nel computer remoto. Quando il membro dwState è MIB_TCP_STATE_LISTEN, questo valore non ha alcun significato.

dwRemotePort

Tipo: DWORD

Numero di porta remota in ordine di byte di rete per la connessione TCP nel computer remoto. Quando il membro dwState è MIB_TCP_STATE_LISTEN, questo membro non ha alcun significato.

La dimensione massima di un numero di porta IP è di 16 bit, quindi devono essere usati solo i 16 bit inferiori. I 16 bit superiori possono contenere dati non inizializzati.

dwOwningPid

Tipo: DWORD

PID del processo che ha emesso un binding di contesto per questa connessione TCP.

dwOffloadState

Tipo: TCP_CONNECTION_OFFLOAD_STATE

Stato di offload per questa connessione TCP. Questo parametro può essere uno dei valori di enumerazione per il TCP_CONNECTION_OFFLOAD_STATE definito nell'intestazione Tcpmib.h .

Commenti

La funzione GetTcpTable2 recupera la tabella di connessione TCP IPv4 nel computer locale e restituisce queste informazioni in una struttura MIB_TCPTABLE2 .

Una matrice di strutture MIB_TCPROW2 è contenuta nella struttura MIB_TCPTABLE2 .

Il membro dwState indica lo stato della voce TCP in un diagramma di stato TCP. Una connessione TCP passa attraverso una serie di stati durante la sua durata. Gli stati sono: LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSING, LAST-ACK, TIME-WAIT e lo stato fittizio CLOSED. Lo stato CLOSED è fittizio perché rappresenta lo stato quando non è presente alcun blocco di controllo trasmissione e pertanto nessuna connessione. Il protocollo TCP è descritto in RFC 793. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc793.txt.

I membri dwLocalPort e dwRemotePort sono in ordine di byte di rete. Per usare i membri dwLocalPort o dwRemotePort , possono essere necessarie le funzioni ntohs o inet_ntoa in Windows Sockets o funzioni simili. I membri dwLocalAddr e dwRemoteAddr vengono archiviati come DWORD nello stesso formato della struttura in_addr . Per usare i membri dwLocalAddr o dwRemoteAddr , potrebbero essere necessarie le funzioni ntohl o inet_ntoa in Windows Sockets o funzioni simili. In Windows Vista e versioni successive è possibile usare le funzioni RtlIpv4AddressToString o RtlIpv4AddressToStringEx per convertire l'indirizzo IPv4 nei membri dwLocalAddr o dwRemoteAddr in una stringa senza caricare la DLL di Windows Sockets.

Esempio

Nell'esempio seguente viene recuperata la tabella di connessione TCP per IPv4 e viene stampato lo stato di ogni connessione rappresentata come struttura MIB_TCPROW2 .

#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_TCPTABLE2 pTcpTable;
    ULONG ulSize = 0;
    DWORD dwRetVal = 0;

    char szLocalAddr[128];
    char szRemoteAddr[128];

    struct in_addr IpAddr;

    int i;

    pTcpTable = (MIB_TCPTABLE2 *) MALLOC(sizeof (MIB_TCPTABLE2));
    if (pTcpTable == NULL) {
        printf("Error allocating memory\n");
        return 1;
    }

    ulSize = sizeof (MIB_TCPTABLE);
// Make an initial call to GetTcpTable2 to
// get the necessary size into the ulSize variable
    if ((dwRetVal = GetTcpTable2(pTcpTable, &ulSize, TRUE)) ==
        ERROR_INSUFFICIENT_BUFFER) {
        FREE(pTcpTable);
        pTcpTable = (MIB_TCPTABLE2 *) MALLOC(ulSize);
        if (pTcpTable == NULL) {
            printf("Error allocating memory\n");
            return 1;
        }
    }
// Make a second call to GetTcpTable2 to get
// the actual data we require
    if ((dwRetVal = GetTcpTable2(pTcpTable, &ulSize, 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:
                wprintf(L"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));
                   
            printf("\tTCP[%d] Owning PID: %d\n", i, pTcpTable->table[i].dwOwningPid);

            printf("\tTCP[%d] Offload State: %ld - ", i,
                   pTcpTable->table[i].dwOffloadState);
            switch (pTcpTable->table[i].dwOffloadState) {
            case TcpConnectionOffloadStateInHost:
                printf("Owned by the network stack and not offloaded \n");
                break;
            case TcpConnectionOffloadStateOffloading:
                printf("In the process of being offloaded\n");
                break;
            case TcpConnectionOffloadStateOffloaded:
                printf("Offloaded to the network interface control\n");
                break;
            case TcpConnectionOffloadStateUploading:
                printf("In the process of being uploaded back to the network stack \n");
                break;
            default:
                printf("UNKNOWN Offload state value\n");
                break;
            }
                   
        }
    } else {
        printf("\tGetTcpTable2 failed with %d\n", dwRetVal);
        FREE(pTcpTable);
        return 1;
    }

    if (pTcpTable != NULL) {
        FREE(pTcpTable);
        pTcpTable = NULL;
    }

    return 0;    
}

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione tcpmib.h (include Iphlpapi.h)

Vedi anche

GetTcp6Table

GetTcp6Table2

GetTcpTable

GetTcpTable2

MIB_TCP6ROW

MIB_TCP6ROW2

MIB_TCP6TABLE

MIB_TCP6TABLE2

MIB_TCPTABLE

MIB_TCPTABLE2

RtlIpv4AddressToString

RtlIpv4AddressToStringEx

SetTcpEntry

TCP_CONNECTION_OFFLOAD_STATE

in_addr

inet_ntoa

ntohl

ntohs