SetIpStatistics-Funktion (iphlpapi.h)

  • Artikel

Die SetIpStatistics-Funktion schaltet die IP-Weiterleitung ein oder aus und legt den Standardwert für die Laufzeit (Time-to-Live, TTL) für den lokalen Computer fest.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD SetIpStatistics(
  [in] PMIB_IPSTATS pIpStats
);

Parameter

[in] pIpStats

Ein Zeiger auf eine MIB_IPSTATS-Struktur . Der Aufrufer sollte die dwForwarding- und dwDefaultTTL-Member dieser Struktur auf die neuen Werte festlegen. Verwenden Sie MIB_USE_CURRENT_TTL oder MIB_USE_CURRENT_FORWARDING, um eines der Member auf dem aktuellen Wert beizubehalten.

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_ACCESS_DENIED
 Der Zugriff wird verweigert. Dieser Fehler wird unter Windows Vista und Windows Server 2008 unter verschiedenen Bedingungen zurückgegeben, die folgendes umfassen: Dem Benutzer fehlen die erforderlichen Administratorrechte auf dem lokalen Computer, oder die Anwendung wird nicht in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausgeführt.
ERROR_INVALID_PARAMETER
 Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn ein NULL-Zeiger im pIpStats-Parameter übergeben wird. Dieser Fehler wird auch zurückgegeben, wenn das dwForwarding-Element in der MIB_IPSTATS Struktur, auf die der pIpStats-Parameter verweist, einen anderen Wert als MIB_IP_NOT_FORWARDING, MIB_IP_FORWARDING oder MIB_USE_CURRENT_FORWARDING enthält.
Andere
 Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Um nur die Standard-TTL festzulegen, kann der Aufrufer auch die SetIpTTL-Funktion verwenden.

Unter Windows Vista und höher kann die SetIpStatistics-Funktion nur von einem Benutzer aufgerufen werden, der als Mitglied der Gruppe Administratoren angemeldet ist. Wenn SetIpStatistics von einem Benutzer aufgerufen wird, der kein Mitglied der Gruppe Administratoren ist, schlägt der Funktionsaufruf fehl, und ERROR_ACCESS_DENIED wird zurückgegeben.

Die SetIpStatistics-Funktion kann auch aufgrund der Benutzerkontensteuerung (User Account Control, UAC) unter Windows Vista und höher fehlschlagen. Wenn eine Anwendung, die diese Funktion enthält, von einem Benutzer ausgeführt wird, der nicht als mitglied der Gruppe Administratoren als der integrierte Administrator angemeldet ist, schlägt dieser Aufruf fehl, es sei denn, die Anwendung wurde in der Manifestdatei mit einem requestedExecutionLevel-Wert gekennzeichnet, der auf requireAdministrator festgelegt ist. Wenn der Anwendung diese Manifestdatei fehlt, muss ein Benutzer, der sich als anderes Mitglied der Administratorgruppe als der integrierte Administrator angemeldet hat, die Anwendung dann in einer erweiterten Shell als integrierter Administrator (RunAs-Administrator) ausführen, damit diese Funktion erfolgreich ist.

Hinweis Unter Windows NT 4.0 und Windows 2000 und höher führt diese Funktion einen privilegierten Vorgang aus. Damit diese Funktion erfolgreich ausgeführt werden kann, muss der Aufrufer als Mitglied der Gruppe Administratoren oder der Gruppe NetworkConfigurationOperators angemeldet sein.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile iphlpapi.h
Bibliothek Iphlpapi.lib
DLL Iphlpapi.dll

Weitere Informationen

IP-Hilfsfunktionsreferenz

IP-Hilfsprogramm-Startseite

MIB_IPSTATS

SetIpStatisticsEx

SetIpTTL