WriteGlobalPwrPolicy-Funktion (powrprof.h)

[WriteGlobalPwrPolicy ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Siehe Hinweise.]

Schreibt globale Energierichtlinieneinstellungen.

Syntax

BOOLEAN WriteGlobalPwrPolicy(
  [in] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Parameter

[in] pGlobalPowerPolicy

Ein Zeiger auf eine GLOBAL_POWER_POLICY Struktur, die die zu schreibenden Energierichtlinieneinstellungen enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die Funktion ersetzt alle vorhandenen einstellungen für globale Energierichtlinien. Jeder Benutzer verfügt über ein separates globales Energieschema, das Energierichtlinieneinstellungen enthält, die für alle Energieschemas für diesen Benutzer gelten.

Verwenden Sie ab Windows Vista die PowerEnumerate-Funktion , um Energieeinstellungen für ein angegebenes Schema aufzulisten und die Power Write-Funktionen, um einzelne Einstellungen zu schreiben.

Weitere Informationen zur Verwendung von PowrProf.h finden Sie unter Energieschemas.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	powrprof.h
Bibliothek	PowrProf.lib
DLL	PowrProf.dll

Weitere Informationen

GLOBAL_POWER_POLICY

Energieverwaltungsfunktionen

ReadGlobalPwrPolicy