SetActivePwrScheme-Funktion (powrprof.h)

[SetActivePwrScheme ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Anwendungen, die für Windows Vista und höher geschrieben wurden, sollten stattdessen PowerSetActiveScheme verwenden.]

Legt das aktive Energieschema fest.

Syntax

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

Parameter

[in] uiID

Der Index des zu aktivierenden Energieschemas.

[in, optional] pGlobalPowerPolicy

Ein Zeiger auf eine optionale GLOBAL_POWER_POLICY-Struktur , die globale Energierichtlinieneinstellungen bereitstellt, die mit dem Energieschema zusammengeführt werden, wenn es aktiv wird.

[in, optional] pPowerPolicy

Ein Zeiger auf eine optionale POWER_POLICY-Struktur , die Energierichtlinieneinstellungen bereitstellt, die mit dem Energieschema zusammengeführt werden sollen, wenn es aktiv wird.

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

Verwenden Sie diese Funktion, um langfristige Änderungen an der Systemkonfiguration vorzunehmen. Verwenden Sie die SetThreadExecutionState-Funktion , um die Systemausführung vorübergehend aufrechtzuerhalten, während eine Anwendung eine Aufgabe ausführt.

Wenn das durch uiID angegebene Energieschema nicht vorhanden ist, gibt die Funktion null zurück.

Wenn lpGlobalPowerPolicyNULL ist, verwendet die Funktion die aktuellen globalen Energierichtlinieneinstellungen, die von WriteGlobalPwrPolicy festgelegt werden. Andernfalls ersetzen die Einstellungen in der angegebenen Struktur die aktuellen globalen Energierichtlinieneinstellungen.

Wenn lpPowerPolicyNULL ist, verwendet die Funktion die aktuellen Energierichtlinieneinstellungen für das Energieschema. Andernfalls ersetzen die Einstellungen in der angegebenen Struktur die aktuellen Energierichtlinieneinstellungen.

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

GetActivePwrScheme

POWER_POLICY

Energieverwaltungsfunktionen

Energieschemas