WritePwrScheme-Funktion (powrprof.h)
[WritePwrScheme ist ab Windows Vista nicht mehr verfügbar. Verwenden Sie stattdessen die PowerEnumerate-Funktion , um Energieeinstellungen für ein angegebenes Schema aufzulisten, und die Power Write-Funktionen, um einzelne Einstellungen zu schreiben.]
Schreibt Richtlinieneinstellungen, die für das angegebene Energieschema eindeutig sind.
Syntax
BOOLEAN WritePwrScheme(
[in] PUINT puiID,
[in] LPCWSTR lpszSchemeName,
[in, optional] LPCWSTR lpszDescription,
[in] PPOWER_POLICY lpScheme
);
Parameter
[in] puiID
Der Index des zu schreibenden Energieschemas. Wenn bereits ein Energieschema mit demselben Index vorhanden ist, wird es ersetzt. Andernfalls wird ein neues Energieschema erstellt.
[in] lpszSchemeName
Der Name des Energieschemas.
[in, optional] lpszDescription
Die Beschreibung des Energieschemas.
[in] lpScheme
Ein Zeiger auf eine 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
Diese Änderung wirkt sich nicht auf die aktuelle Systemenergierichtlinie aus. Um diese Änderung auf die aktuelle Systemenergierichtlinie anzuwenden, rufen Sie die SetActivePwrScheme-Funktion mit dem Index dieses Energieschemas auf.
Mithilfe von WritePwrScheme geschriebene Energierichtlinienschemas werden dauerhaft in den Systemregistrierungsstrukturen gespeichert und bleiben für die Verwendung im Power Options-Systemsteuerungsprogramm oder durch nachfolgende Aufrufe der Energieschema-API verfügbar. Um ein Energieschema dauerhaft aus dem System zu entfernen, rufen Sie die DeletePwrScheme-Funktion auf.
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 |