Funzione GetIcmpStatisticsEx (iphlpapi.h)

Articolo
03/05/2024

La funzione GetIcmpStatisticsEx recupera le statistiche ICMP (Internet Control Message Protocol) per il computer locale. La funzione GetIcmpStatisticsEx è in grado di recuperare le statistiche ICMP IPv6.

Sintassi

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

Parametri

[out] Statistics

Puntatore a una struttura MIB_ICMP_EX che contiene statistiche ICMP per il computer locale.

[in] Family

Famiglia di protocolli per cui recuperare le statistiche ICMP. I possibili valori sono i seguenti:

Valore	Significato
AF_INET	Protocollo Internet versione 4 (IPv4).
AF_INET6	Protocollo IP versione 6 (IPv6).

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Il parametro pStats è NULL o non punta alla memoria valida oppure il parametro dwFamily non è un valore valido.
ERROR_NOT_SUPPORTED	Questa funzione non è supportata nel sistema operativo in cui è stata effettuata la chiamata alla funzione.
Altri	Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

GetIpStatisticsEx può essere usato per ottenere le statistiche ICMP per IPv4 o IPv6 nel computer locale.

La funzione GetIcmpStatistics restituisce le statistiche ICMP solo per IPv4 nel computer locale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll