WritePwrScheme-Funktion (powrprof.h)

Artikel
08/25/2023

[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