Función GetIcmpStatisticsEx (iphlpapi.h)

Artículo
08/24/2023

La función GetIcmpStatisticsEx recupera estadísticas del Protocolo de mensajes de control de Internet (ICMP) para el equipo local. La función GetIcmpStatisticsEx es capaz de recuperar estadísticas ICMP de IPv6.

Sintaxis

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

Parámetros

[out] Statistics

Puntero a una estructura MIB_ICMP_EX que contiene estadísticas icMP para el equipo local.

[in] Family

Familia de protocolos para la que se recuperan las estadísticas de ICMP. Debe ser una de las siguientes:

Valor	Significado
AF_INET	Protocolo de Internet versión 4 (IPv4).
AF_INET6	Protocolo de Internet versión 6 (IPv6).

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	El parámetro pStats es NULL o no apunta a memoria válida o el parámetro dwFamily no es un valor válido.
ERROR_NOT_SUPPORTED	Esta función no se admite en el sistema operativo en el que se realizó la llamada de función.
Otros	Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

GetIpStatisticsEx se puede usar para obtener las estadísticas de ICMP para IPv4 o IPv6 en el equipo local.

La función GetIcmpStatistics devuelve las estadísticas icMP solo para IPv4 en el equipo local.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	iphlpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll