Função SetSuspendState (powrprof.h)
Suspende o sistema desligando a energia. Dependendo do parâmetro Hibernate , o sistema entra em um estado de suspensão (suspensão) ou hibernação (S4).
Sintaxe
BOOLEAN SetSuspendState(
[in] BOOLEAN bHibernate,
[in] BOOLEAN bForce,
[in] BOOLEAN bWakeupEventsDisabled
);
Parâmetros
[in] bHibernate
Se esse parâmetro for TRUE, o sistema hibernará. Se o parâmetro for FALSE, o sistema será suspenso.
[in] bForce
Esse parâmetro não tem nenhum efeito.
[in] bWakeupEventsDisabled
Se esse parâmetro for TRUE, o sistema desabilita todos os eventos de ativação. Se o parâmetro for FALSE, todos os eventos de ativação do sistema permanecerão habilitados.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O processo de chamada deve ter o privilégio SE_SHUTDOWN_NAME . Para habilitar o privilégio SE_SHUTDOWN_NAME , use a função AdjustTokenPrivileges . Para obter mais informações, consulte Alterando privilégios em um token.
Um aplicativo pode usar SetSuspendState para fazer a transição do sistema do estado de trabalho para o estado em espera (suspensão) ou, opcionalmente, hibernar (S4). Essa função é semelhante à função SetSystemPowerState .
Para obter mais informações sobre como usar PowrProf.h, consulte Power Schemes. Para obter informações sobre eventos que podem ativar o sistema, consulte Eventos de ativação do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | powrprof.h |
| Biblioteca | PowrProf.lib |
| DLL | PowrProf.dll |