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

Vedi anche

PBT_APMQUERYSUSPEND

PBT_APMSUSPEND

Funzioni di risparmio energia