GetIpStatisticsEx-Funktion (iphlpapi.h)

Artikel
02/28/2024

Die GetIpStatisticsEx-Funktion ruft die IP-Statistiken (Internet Protocol) für den aktuellen Computer ab. Die GetIpStatisticsEx-Funktion unterscheidet sich von der GetIpStatistics-Funktion darin, dass GetIpStatisticsEx auch die IPv6-Protokollfamilie (Internet Protocol Version 6) unterstützt.

Syntax

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

Parameter

[out] Statistics

Ein Zeiger auf eine MIB_IPSTATS-Struktur , die die IP-Statistiken für den lokalen Computer empfängt.

[in] Family

Die Protokollfamilie, für die Statistiken abgerufen werden sollen. Dieser Parameter muss einer der folgenden Werte 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, auf dem der Funktionsaufruf durchgeführt wurde, nicht unterstützt.
Andere	Verwenden Sie FormatMessage , um die Meldungszeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

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

Die GetIpStatistics-Funktion gibt die 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