SetSuspendState-Funktion (powrprof.h)

Hält das System an, indem die Stromversorgung heruntergefahren wird. Abhängig vom Hibernate-Parameter wechselt das System entweder in den Ruhezustand (Ruhezustand) oder in den Ruhezustand (S4).

Syntax

BOOLEAN SetSuspendState(
  [in] BOOLEAN bHibernate,
  [in] BOOLEAN bForce,
  [in] BOOLEAN bWakeupEventsDisabled
);

Parameter

[in] bHibernate

Wenn dieser Parameter TRUE ist, wird das System in den Ruhezustand versetzt. Wenn der Parameter FALSE ist, wird das System angehalten.

[in] bForce

Dieser Parameter hat keine Auswirkungen.

[in] bWakeupEventsDisabled

Wenn dieser Parameter TRUE ist, deaktiviert das System alle Aktivierungsereignisse. Wenn der Parameter FALSE ist, bleiben alle Systemreaktivierungsereignisse aktiviert.

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

Der aufrufende Prozess muss über die berechtigung SE_SHUTDOWN_NAME verfügen. Verwenden Sie die Funktion AdjustTokenPrivileges, um die Berechtigung SE_SHUTDOWN_NAME zu aktivieren. Weitere Informationen finden Sie unter Ändern von Berechtigungen in einem Token.

Eine Anwendung kann SetSuspendState verwenden, um das System vom Betriebszustand in den Standbyzustand (Standbymodus) oder optional in den Ruhezustand (S4) zu wechseln. Diese Funktion ähnelt der SetSystemPowerState-Funktion .

Weitere Informationen zur Verwendung von PowrProf.h finden Sie unter Energieschemas. Informationen zu Ereignissen, die das System aktivieren können, finden Sie unter Systemreaktivierungsereignisse.

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

PBT_APMQUERYSUSPEND

PBT_APMSUSPEND

Energieverwaltungsfunktionen