Freigeben über


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
);

Parameter

[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.

Rückgabewert

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.

Anforderungen

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

Siehe auch

PowerCreateRequest

PowerSetRequest