structure MIB_TCP6ROW_OWNER_PID (tcpmib.h)
La structure MIB_TCP6ROW_OWNER_PID contient des informations qui décrivent une connexion TCP IPv6 associée à un ID de processus (PID) spécifique.
Syntaxe
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;
Membres
ucLocalAddr[16]
Type : UCHAR[16]
Adresse IPv6 du point de terminaison local de 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 dans l’ordre d’octet réseau pour l’adresse IPv6 locale.
dwLocalPort
Type : DWORD
Numéro de port dans l’ordre d’octet réseau pour le point de terminaison local de la connexion TCP sur l’ordinateur local.
ucRemoteAddr[16]
Type : UCHAR[16]
Adresse IPv6 du point de terminaison distant de la connexion TCP sur l’ordinateur distant. Lorsque le membre dwState est MIB_TCP_STATE_LISTEN, cette valeur n’a aucune signification.
dwRemoteScopeId
Type : DWORD
ID d’étendue dans l’ordre d’octet réseau pour l’adresse IPv6 distante.
dwRemotePort
Type : DWORD
Numéro de port dans l’ordre d’octet réseau pour le point de terminaison distant de la connexion TCP sur l’ordinateur distant.
dwState
Type : DWORD
État de la connexion TCP. Ce membre peut être l’une des valeurs de l’énumération MIB_TCP_STATE définie dans le fichier d’en-tête Tcpmib.h . Notez que le fichier d’en-tête Tcpmib.h est automatiquement inclus dans Iprtrmib.h, qui est automatiquement inclus dans le fichier d’en-tête Iphlpapi.h . Les fichiers d’en-tête Tcpmib.h et Iprtrmib.h ne doivent jamais être utilisés directement.
dwOwningPid
Type : DWORD
PID du processus local qui a émis une liaison de contexte pour cette connexion TCP.
Remarques
La structure MIB_TCP6TABLE_OWNER_PID est retournée par un appel à GetExtendedTcpTable avec le paramètre TableClass défini sur TCP_TABLE_OWNER_PID_LISTENER, TCP_TABLE_OWNER_PID_CONNECTIONS ou TCP_TABLE_OWNER_PID_ALL à partir de l’énumération TCP_TABLE_CLASS et le paramètre ulAf défini sur AF_INET6. La structure MIB_TCP6TABLE_OWNER_PID contient un tableau de structures MIB_TCP6ROW_OWNER_PID .
Le membre dwState indique l’état de l’entrée TCP dans un diagramme d’état TCP. Une connexion TCP progresse à travers 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 FERMÉ. L’état FERMÉ est fictif, car il représente l’état lorsqu’il n’existe aucun 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 d’octet réseau. Pour utiliser les membres dwLocalPort ou dwRemotePort , les fonctions ntohs ou inet_ntoa dans les sockets Windows ou des fonctions similaires peuvent être nécessaires.
Les membres dwLocalScopeId et dwRemoteScopeId sont dans l’ordre d’octet réseau. Pour utiliser les membres dwLocalScopeId ou dwRemoteScopeId , les fonctions ntohl ou inet_ntoa dans les sockets Windows ou des fonctions similaires peuvent être nécessaires.
Les membres ucLocalAddr et ucRemoteAddr sont stockés dans un tableau de caractères par ordre d’octet réseau. Les fonctions RtlIpv6AddressToString ou RtlIpv6AddressToStringEx peuvent être utilisées pour convertir l’adresse IPv6 dans les membres ucLocalAddr ou ucRemoteAddr en chaîne sans charger la DLL windows Sockets.
Dans le Kit de développement logiciel (SDK) Microsoft Windows publié pour Windows Vista et versions ultérieures, la organization des fichiers d’en-tête a changé. Cette structure est définie dans le fichier d’en-tête Tcpmib.h , et non dans le fichier d’en-tête Iprtrmib.h . Notez que le fichier d’en-tête Tcpmib.h est automatiquement inclus dans Iprtrmib.h, qui est automatiquement inclus dans le fichier d’en-tête Iphlpapi.h . Les fichiers d’en-tête Tcpmib.h et Iprtrmib.h ne doivent jamais être utilisés directement.
Configuration requise
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement] |
| En-tête | tcpmib.h (inclure Iphlpapi.h) |