GetIcmpStatisticsEx, fonction (iphlpapi.h)

Article
03/02/2024

La fonction GetIcmpStatisticsEx récupère les statistiques ICMP (Internet Control Message Protocol) pour l’ordinateur local. La fonction GetIcmpStatisticsEx est capable de récupérer des statistiques ICMP IPv6.

Syntaxe

IPHLPAPI_DLL_LINKAGE ULONG GetIcmpStatisticsEx(
  [out] PMIB_ICMP_EX Statistics,
  [in]  ULONG        Family
);

Paramètres

[out] Statistics

Pointeur vers une structure MIB_ICMP_EX qui contient des statistiques ICMP pour l’ordinateur local.

[in] Family

Famille de protocoles pour laquelle récupérer des statistiques ICMP. Doit prendre l'une des valeurs suivantes :

Valeur	Signification
AF_INET	Protocole Internet version 4 (IPv4).
AF_INET6	Protocole IPv6 (Internet Protocol version 6).

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_INVALID_PARAMETER	Le paramètre pStats a la valeur NULL ou ne pointe pas vers la mémoire valide, ou le paramètre dwFamily n’est pas une valeur valide.
ERROR_NOT_SUPPORTED	Cette fonction n’est pas prise en charge sur le système d’exploitation sur lequel l’appel de fonction a été effectué.
Autres	Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée.

Remarques

GetIpStatisticsEx peut être utilisé pour obtenir les statistiques ICMP pour IPv4 ou IPv6 sur l’ordinateur local.

La fonction GetIcmpStatistics retourne les statistiques ICMP uniquement pour IPv4 sur l’ordinateur local.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	iphlpapi.h
Bibliothèque	Iphlpapi.lib
DLL	Iphlpapi.dll