GetTcp6Table2, fonction (iphlpapi.h)

La fonction GetTcp6Table2 récupère la table de connexion TCP pour IPv6.

Syntaxe

IPHLPAPI_DLL_LINKAGE ULONG GetTcp6Table2(
  [out]     PMIB_TCP6TABLE2 TcpTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Paramètres

[out] TcpTable

Pointeur vers une mémoire tampon qui reçoit la table de connexion TCP pour IPv6 en tant que structure MIB_TCP6TABLE2 .

[in, out] SizePointer

Lors de l’entrée, spécifie la taille de la mémoire tampon pointée vers le paramètre TcpTable .

En sortie, si la mémoire tampon n’est pas assez grande pour contenir la table de connexion TCP retournée, la fonction définit ce paramètre comme étant la taille de mémoire tampon requise.

[in] Order

Valeur qui spécifie si la table de connexion TCP doit être triée. Si ce paramètre a la valeur TRUE, la table est triée par ordre croissant, en commençant par l’adresse IP locale la plus basse. Si ce paramètre a la valeur FALSE, la table s’affiche dans l’ordre dans lequel ils ont été récupérés.

Les valeurs suivantes sont comparées (telles qu’elles sont répertoriées) lors de l’ordre des points de terminaison TCP :

  1. Adresse IPv6 locale
  2. ID d’étendue locale
  3. Port local
  4. Adresse IPv6 distante
  5. ID d’étendue distante
  6. Port distant

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour Description
ERROR_INSUFFICIENT_BUFFER
La mémoire tampon pointée vers le paramètre TcpTable n’est pas assez grande. La taille requise est retournée dans la variable pointée vers par le paramètre SizePointer .
ERROR_INVALID_PARAMETER
Le paramètre SizePointer a la valeur NULL ou GetTcp6Table2 ne peut pas écrire dans la mémoire pointée par le paramètre SizePointer .
ERROR_NOT_SUPPORTED
Cette fonction n’est pas prise en charge sur le système d’exploitation utilisé sur le système local.
Autres
Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

Notes

La fonction GetTcp6Table2 est définie sur Windows Vista et versions ultérieures.

La fonction GetTcp6Table2 est une version améliorée de la fonction GetTcp6Table qui récupère également des informations sur l’état de déchargement TCP de la connexion TCP.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête iphlpapi.h
Bibliothèque Iphlpapi.lib
DLL Iphlpapi.dll

Voir aussi

GetExtendedTcpTable

GetOwnerModuleFromTcp6Entry

GetTcp6Table

GetTcpStatisticsEx

GetTcpTable

MIB_TCP6ROW

MIB_TCP6ROW2

MIB_TCP6ROW_OWNER_MODULE

MIB_TCP6ROW_OWNER_PID

MIB_TCP6TABLE

MIB_TCP6TABLE2

MIB_TCP6TABLE_OWNER_MODULE

MIB_TCP6TABLE_OWNER_PID