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 |