struttura MIB_TCP6ROW_OWNER_PID (tcpmib.h)

Articolo
08/26/2023

La struttura MIB_TCP6ROW_OWNER_PID contiene informazioni che descrivono una connessione TCP IPv6 associata a un ID processo specifico.

Sintassi

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;

Members

ucLocalAddr[16]

Tipo: UCHAR[16]

Indirizzo IPv6 per l'endpoint locale della connessione TCP nel computer locale. Il valore zero indica che il listener può accettare una connessione su qualsiasi interfaccia.

dwLocalScopeId

Tipo: DWORD

ID ambito nell'ordine dei byte di rete per l'indirizzo IPv6 locale.

dwLocalPort

Tipo: DWORD

Numero di porta in ordine di byte di rete per l'endpoint locale della connessione TCP nel computer locale.

ucRemoteAddr[16]

Tipo: UCHAR[16]

Indirizzo IPv6 dell'endpoint remoto della connessione TCP nel computer remoto. Quando il membro dwState è MIB_TCP_STATE_LISTEN, questo valore non ha alcun significato.

dwRemoteScopeId

Tipo: DWORD

ID ambito nell'ordine dei byte di rete per l'indirizzo IPv6 remoto.

dwRemotePort

Tipo: DWORD

Numero di porta in ordine di byte di rete per l'endpoint remoto della connessione TCP nel computer remoto.

dwState

Tipo: DWORD

Stato della connessione TCP. Questo membro può essere uno dei valori dell'enumerazione MIB_TCP_STATE definita nel file di intestazione Tcpmib.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.

dwOwningPid

Tipo: DWORD

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

Commenti

La struttura MIB_TCP6TABLE_OWNER_PID viene restituita da una chiamata a GetExtendedTcpTable con il parametro TableClass impostato su TCP_TABLE_OWNER_PID_LISTENER, TCP_TABLE_OWNER_PID_CONNECTIONS o TCP_TABLE_OWNER_PID_ALL dall'enumerazione TCP_TABLE_CLASS e il parametro ulAf impostato su AF_INET6. La struttura MIB_TCP6TABLE_OWNER_PID contiene una matrice di strutture MIB_TCP6ROW_OWNER_PID .

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 dwLocalScopeId e dwRemoteScopeId sono in ordine di byte di rete. Per usare i membri dwLocalScopeId o dwRemoteScopeId , possono essere necessarie le funzioni ntohl o inet_ntoa in Windows Sockets o funzioni simili.

I membri ucLocalAddr e ucRemoteAddr vengono archiviati in una matrice di caratteri in ordine di byte di rete. Le funzioni RtlIpv6AddressToString o RtlIpv6AddressToStringEx possono essere usate per convertire l'indirizzo IPv6 nei membri ucLocalAddr o ucRemoteAddr in una stringa senza caricare la DLL di Windows Sockets.

In Microsoft Windows Software Development Kit (SDK) rilasciato per Windows Vista e versioni successive, l'organizzazione dei file di intestazione è cambiata. Questa struttura è 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.

Requisiti


Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Intestazione	tcpmib.h (include Iphlpapi.h)