PowerClearRequest-Funktion (winbase.h)

Verringert die Anzahl der Energieanforderungen des angegebenen Typs für ein Energieanforderungsobjekt.

Syntax

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

Ein Handle für ein Power Request-Objekt.

[in] RequestType

Der Energieanforderungstyp, der dekrementiert werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
PowerRequestDisplayRequired	Die Anzeige bleibt auch dann aktiviert, wenn für einen längeren Zeitraum keine Benutzereingaben vorhanden sind.
PowerRequestSystemRequired	Das System wird nach einer Phase der Benutzerinaktivität weiterhin ausgeführt, anstatt in den Ruhezustand zu wechseln.
PowerRequestAwayModeRequired	Das System wechselt in den Abwesenheitsmodus statt in den Standbymodus. Im Abwesenheitsmodus wird das System weiterhin ausgeführt, schaltet jedoch Audio und Video aus, um den Anschein des Ruhezustands zu verleihen.
PowerRequestExecutionRequired	Der aufrufende Prozess wird weiterhin ausgeführt, anstatt von Mechanismen zur Verwaltung der Prozesslebensdauer angehalten oder beendet zu werden. Wann und wie lange der Prozess ausgeführt werden darf, hängt von den Einstellungen des Betriebssystems und der Energierichtlinie ab. Wenn eine PowerRequestExecutionRequired-Anforderung aktiv ist, impliziert dies PowerRequestSystemRequired. Der Anforderungstyp PowerRequestExecutionRequired kann nur von Anwendungen verwendet werden. Dienste können diesen Anforderungstyp nicht verwenden. Windows 7 und Windows Server 2008 R2: Dieser Anforderungstyp wird ab Windows 8 und Windows Server 2012 unterstützt.

Wenn die Funktion erfolgreich ist, wird ein Wert ungleich null zurückgegeben.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll