GetActivePwrScheme-Funktion (powrprof.h)

[GetActivePwrScheme 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 PowerGetActiveScheme verwenden.]

Ruft den Index des aktiven Energieschemas ab.

Syntax

BOOLEAN GetActivePwrScheme(
  [out] PUINT puiID
);

Parameter

[out] puiID

Ein Zeiger auf eine Variable, die den Index des aktiven Energieschemas empfängt.

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

Das aktive Energieschema bleibt aktiv, bis entweder der Benutzer mithilfe des Systemsteuerungsprogramms "Energieoptionen" ein neues Energieschema festlegt oder eine Anwendung die SetActivePwrScheme-Funktion aufruft .

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

Energieverwaltungsfunktionen

Energieschemas

SetActivePwrScheme