GetIpStatisticsEx, fonction (iphlpapi.h)

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

Voir aussi

GetIpStatistics

GetTcpStatisticsEx

GetUdpStatisticsEx

Informations de référence sur les fonctions d’assistance IP

Page de démarrage de l’assistance IP

MIB_IPSTATS