Função SetSystemPowerState (winbase.h)

Artigo
08/27/2023

[SetSystemPowerState está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Os aplicativos gravados para o Windows Vista e posteriores devem usar SetSuspendState em vez disso.]

Suspende o sistema desligando a energia. Dependendo do parâmetro ForceFlag , a função suspende a operação imediatamente ou solicita permissão de todos os aplicativos e drivers de dispositivo antes de fazer isso.

Sintaxe

BOOL SetSystemPowerState(
  [in] BOOL fSuspend,
  [in] BOOL fForce
);

Parâmetros

[in] fSuspend

Se esse parâmetro for TRUE, o sistema será suspenso. Se o parâmetro for FALSE, o sistema hibernará.

[in] fForce

Esse parâmetro não tem nenhum efeito.

Valor retornado

Se a energia tiver sido suspensa e restaurada posteriormente, o valor retornado será diferente de zero.

Se o sistema não tiver sido suspenso, 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.

Se qualquer aplicativo ou driver negar permissão para suspender a operação, a função transmitirá um evento PBT_APMQUERYSUSPENDFAILED para cada aplicativo e driver. Se a energia for suspensa, essa função retornará somente depois que a operação do sistema for retomada e as mensagens relacionadas WM_POWERBROADCAST tiverem sido transmitidas para todos os aplicativos e drivers.

Essa função é semelhante à função SetSuspendState .

Para compilar um aplicativo que usa essa função, defina a macro _WIN32_WINNT como 0x0400 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Requisitos


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	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll