Función GetIpStatisticsEx (iphlpapi.h)

Artículo
03/05/2024

La función GetIpStatisticsEx recupera las estadísticas del Protocolo de Internet (IP) del equipo actual. La función GetIpStatisticsEx difiere de la función GetIpStatistics en que GetIpStatisticsEx también admite la familia de protocolos de Protocolo de Internet versión 6 (IPv6).

Sintaxis

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

Parámetros

[out] Statistics

Puntero a una estructura de MIB_IPSTATS que recibe las estadísticas de IP del equipo local.

[in] Family

Familia de protocolos para la que se van a recuperar estadísticas. Este parámetro debe ser uno de los siguientes valores:

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 ejecuta 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 para el error devuelto.

Comentarios

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

La función GetIpStatistics devuelve las estadísticas 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