Funzione SetSuspendState (powrprof.h)
Sospende il sistema arrestando l'alimentazione. A seconda del parametro Hibernate , il sistema immette uno stato di sospensione (sospensione) o di ibernazione (S4).
Sintassi
BOOLEAN SetSuspendState(
[in] BOOLEAN bHibernate,
[in] BOOLEAN bForce,
[in] BOOLEAN bWakeupEventsDisabled
);
Parametri
[in] bHibernate
Se questo parametro è TRUE, l'ibernazione del sistema. Se il parametro è FALSE, il sistema viene sospeso.
[in] bForce
Il parametro non ha alcun effetto.
[in] bWakeupEventsDisabled
Se questo parametro è TRUE, il sistema disabilita tutti gli eventi di riattivazione. Se il parametro è FALSE, gli eventi di riattivazione del sistema rimangono abilitati.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Il processo di chiamata deve avere il privilegio di SE_SHUTDOWN_NAME . Per abilitare il privilegio SE_SHUTDOWN_NAME , usare la funzione AdjustTokenPrivileges . Per altre informazioni, vedere Modifica dei privilegi in un token.
Un'applicazione può usare SetSuspendState per eseguire la transizione del sistema dallo stato di lavoro al standby (sospensione) o facoltativamente, lo stato di ibernazione (S4). Questa funzione è simile alla funzione SetSystemPowerState .
Per altre informazioni sull'uso di PowrProf.h, vedere Schemi di alimentazione. Per informazioni sugli eventi che possono riattivare il sistema, vedere Eventi di riattivazione del sistema.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | powrprof.h |
| Libreria | PowrProf.lib |
| DLL | PowrProf.dll |