GetTcp6Table2, fonction (iphlpapi.h)

Article
08/24/2023

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 :

Adresse IPv6 locale
ID d’étendue locale
Port local
Adresse IPv6 distante
ID d’étendue distante
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