GetIpStatisticsEx, fonction (iphlpapi.h)

Article
03/04/2024

La fonction GetIpStatisticsEx récupère les statistiques ip (Internet Protocol) de l’ordinateur actuel. La fonction GetIpStatisticsEx diffère de la fonction GetIpStatistics en ce que GetIpStatisticsEx prend également en charge la famille de protocoles IPv6 (Internet Protocol version 6).

Syntaxe

IPHLPAPI_DLL_LINKAGE ULONG GetIpStatisticsEx(
  [out] PMIB_IPSTATS Statistics,
  [in]  ULONG        Family
);

Paramètres

[out] Statistics

Pointeur vers une structure MIB_IPSTATS qui reçoit les statistiques IP de l’ordinateur local.

[in] Family

Famille de protocoles pour laquelle récupérer des statistiques. Ce paramètre doit avoir 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 de l’erreur retournée.

Remarques

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

La fonction GetIpStatistics retourne les statistiques pour IPv4 uniquement 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