Compartilhar via

Função SetSuspendState (powrprof.h)

  • Artigo

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

Confira também

PBT_APMQUERYSUSPEND

PBT_APMSUSPEND

Funções de gerenciamento de energia