Funzione GetIpStatisticsEx (iphlpapi.h)

Articolo
03/14/2023

La funzione GetIpStatisticsEx recupera le statistiche di Internet Protocol (IP) per il computer corrente. La funzione GetIpStatisticsEx differisce dalla funzione GetIpStatistics in cui GetIpStatisticsEx supporta anche la famiglia di protocolli IPv6 (Internet Protocol 6).

Sintassi

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

Parametri

[out] Statistics

Puntatore a una struttura MIB_IPSTATS che riceve le statistiche IP per il computer locale.

[in] Family

Famiglia di protocolli per cui recuperare le statistiche. Questo parametro deve essere uno dei valori 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 IP per IPv4 o IPv6 nel computer locale.

La funzione GetIpStatistics restituisce le statistiche 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