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 |