MIB_TCP6ROW2 structure (tcpmib.h)

Article
08/26/2023

La structure MIB_TCP6ROW2 contient des informations qui décrivent une connexion TCP IPv6.

Syntaxe

typedef struct _MIB_TCP6ROW2 {
  IN6_ADDR                     LocalAddr;
  DWORD                        dwLocalScopeId;
  DWORD                        dwLocalPort;
  IN6_ADDR                     RemoteAddr;
  DWORD                        dwRemoteScopeId;
  DWORD                        dwRemotePort;
  MIB_TCP_STATE                State;
  DWORD                        dwOwningPid;
  TCP_CONNECTION_OFFLOAD_STATE dwOffloadState;
} MIB_TCP6ROW2, *PMIB_TCP6ROW2;

Membres

LocalAddr

Type : IN6_ADDR

Adresse IPv6 locale pour la connexion TCP sur l’ordinateur local. La valeur zéro indique que l’écouteur peut accepter une connexion sur n’importe quelle interface.

dwLocalScopeId

Type : DWORD

ID d’étendue locale pour la connexion TCP sur l’ordinateur local.

dwLocalPort

Type : DWORD

Numéro de port local dans l’ordre d’octet du réseau pour la connexion TCP sur l’ordinateur local.

La taille maximale d’un numéro de port IP étant de 16 bits, seuls les 16 bits inférieurs doivent être utilisés. Les 16 bits supérieurs peuvent contenir des données non initialisées.

RemoteAddr

Type : IN6_ADDR

Adresse IPv6 de la connexion TCP sur l’ordinateur distant. Lorsque le membre de l’État est MIB_TCP_STATE_LISTEN, cette valeur n’a aucune signification.

dwRemoteScopeId

Type : DWORD

ID d’étendue distante pour la connexion TCP sur l’ordinateur distant. Lorsque le membre de l’État est MIB_TCP_STATE_LISTEN, cette valeur n’a aucune signification.

dwRemotePort

Type : DWORD

Numéro de port distant dans l’ordre d’octet du réseau pour la connexion TCP sur l’ordinateur distant. Lorsque le membre de l’État est MIB_TCP_STATE_LISTEN, cette valeur n’a aucune signification.

La taille maximale d’un numéro de port IP étant de 16 bits, seuls les 16 bits inférieurs doivent être utilisés. Les 16 bits supérieurs peuvent contenir des données non initialisées.

State

Type : MIB_TCP_STATE

État de la connexion TCP. Ce membre peut être l’une des valeurs du type d’énumération MIB_TCP_STATE défini dans le fichier d’en-tête Tcpmib.h .

Valeur	Signification
MIB_TCP_STATE_CLOSED 1	La connexion TCP est à l’état CLOSED qui ne représente aucun état de connexion.
MIB_TCP_STATE_LISTEN 2	La connexion TCP est à l’état LISTEN en attente d’une demande de connexion à partir d’un port et d’un port TCP distants.
MIB_TCP_STATE_SYN_SENT 3	La connexion TCP est dans l’état SYN-SENT en attente d’une demande de connexion correspondante après avoir envoyé une demande de connexion (paquet SYN).
MIB_TCP_STATE_SYN_RCVD 4	La connexion TCP est à l’état SYN-RECEIVED en attente d’un accusé de réception de demande de connexion de confirmation après avoir à la fois reçu et envoyé une demande de connexion (paquet SYN).
MIB_TCP_STATE_ESTAB 5	La connexion TCP est dans l’état ESTABLISHED qui représente une connexion ouverte, les données reçues peuvent être remises à l’utilisateur. Il s’agit de l’état normal pour la phase de transfert de données de la connexion TCP.
MIB_TCP_STATE_FIN_WAIT1 6	La connexion TCP est à l’état FIN-WAIT-1 en attente d’une demande d’arrêt de connexion à partir du protocole TCP distant ou d’un accusé de réception de la demande d’arrêt de connexion précédemment envoyée.
MIB_TCP_STATE_FIN_WAIT2 7	La connexion TCP est à l’état FIN-WAIT-1 en attente d’une demande d’arrêt de connexion à partir du protocole TCP distant.
MIB_TCP_STATE_CLOSE_WAIT 8	La connexion TCP est à l’état CLOSE-WAIT en attente d’une demande d’arrêt de connexion de la part de l’utilisateur local.
MIB_TCP_STATE_CLOSING 9	La connexion TCP est dans l’état CLOSING en attente d’un accusé de réception de demande d’arrêt de connexion à partir du protocole TCP distant.
MIB_TCP_STATE_LAST_ACK 10	La connexion TCP est dans l’état LAST-ACK en attente d’un accusé de réception de la demande d’arrêt de connexion précédemment envoyée au tcp distant (qui inclut un accusé de réception de sa demande d’arrêt de connexion).
MIB_TCP_STATE_TIME_WAIT 11	La connexion TCP est à l’état TIME-WAIT en attendant suffisamment de temps pour s’assurer que le TCP distant a reçu l’accusé de réception de sa demande d’arrêt de connexion.
MIB_TCP_STATE_DELETE_TCB 12	La connexion TCP est dans l’état delete TCB qui représente la suppression du bloc de contrôle de transmission (TCB), une structure de données utilisée pour gérer les informations sur chaque entrée TCP.

dwOwningPid

Type : DWORD

PID du processus qui a émis une liaison de contexte pour cette connexion TCP.

dwOffloadState

Type : TCP_CONNECTION_OFFLOAD_STATE

État de déchargement pour cette connexion TCP. Ce paramètre peut être l’une des valeurs d’énumération pour l’TCP_CONNECTION_OFFLOAD_STATE définie dans l’en-tête Tcpmib.h .

Remarques

La structure MIB_TCP6ROW2 est définie sur Windows Vista et versions ultérieures.

La fonction GetTcp6Table2 récupère la table de connexion TCP IPv6 sur l’ordinateur local et retourne ces informations dans une structure MIB_TCP6TABLE2 .

Un tableau de structures MIB_TCP6ROW2 sont contenues dans la structure MIB_TCP6TABLE2 .

Le membre State indique l’état de l’entrée TCP dans un diagramme d’état TCP. Une connexion TCP progresse dans une série d’états au cours de sa durée de vie. Les états sont : LISTEN, SYN-SENT, SYN-RECEIVED, ESTABLISHED, FIN-WAIT-1, FIN-WAIT-2, CLOSE-WAIT, CLOSING, LAST-ACK, TIME-WAIT et l’état fictif CLOSED. L’état CLOSED est fictif, car il représente l’état lorsqu’il n’y a pas de bloc de contrôle de transmission et, par conséquent, aucune connexion. Le protocole TCP est décrit dans RFC 793. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc793.txt.

Les membres dwLocalPort et dwRemotePort sont dans l’ordre des octets réseau. Pour utiliser les membres dwLocalPort ou dwRemotePort , les fonctions ntohs ou inet_ntoa dans windows Sockets ou des fonctions similaires peuvent être nécessaires.

Les membres dwLocalScopeId et dwRemoteScopeId sont dans l’ordre d’octet du réseau. Pour utiliser les membres dwLocalScopeId ou dwRemoteScopeId , les fonctions ntohl ou inet_ntoa dans Windows Sockets ou des fonctions similaires peuvent être nécessaires.

Les membres LocalAddr et RemoteAddr sont stockés dans in6_addr structures. Les fonctions RtlIpv6AddressToString ou RtlIpv6AddressToStringEx peuvent être utilisées pour convertir l’adresse IPv6 des membres LocalAddr ou RemoteAddr en chaîne sans charger la DLL Windows Sockets.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	tcpmib.h (include Iphlpapi.h)