GetIcmpStatisticsEx-Funktion (iphlpapi.h)

Artikel
02/28/2024

Die GetIcmpStatisticsEx-Funktion ruft ICMP-Statistiken (Internet Control Message Protocol) für den lokalen Computer ab. Die GetIcmpStatisticsEx-Funktion kann IPv6-ICMP-Statistiken abrufen.

Syntax

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

Parameter

[out] Statistics

Ein Zeiger auf eine MIB_ICMP_EX-Struktur , die ICMP-Statistiken für den lokalen Computer enthält.

[in] Family

Die Protokollfamilie, für die ICMP-Statistiken abgerufen werden sollen. Dies muss eine der folgenden Ressourcen sein:

Wert	Bedeutung
AF_INET	Internetprotokoll, Version 4 (IPv4).
AF_INET6	Internet Protocol, Version 6 (IPv6).

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Der pStats-Parameter ist NULL oder zeigt nicht auf gültigen Arbeitsspeicher, oder der dwFamily-Parameter ist kein gültiger Wert.
ERROR_NOT_SUPPORTED	Diese Funktion wird auf dem Betriebssystem, unter dem der Funktionsaufruf erfolgt ist, nicht unterstützt.
Andere	Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

GetIpStatisticsEx kann verwendet werden, um die ICMP-Statistiken für IPv4 oder IPv6 auf dem lokalen Computer abzurufen.

Die GetIcmpStatistics-Funktion gibt die ICMP-Statistiken nur für IPv4 auf dem lokalen Computer zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll