Compartilhar via


Função GetSystemPowerStatus (winbase.h)

Recupera o status de energia do sistema. O status indica se o sistema está em execução na energia AC ou DC, se a bateria está carregando no momento, quanta duração da bateria permanece e se a economia de bateria está ativada ou desativada.

Sintaxe

BOOL GetSystemPowerStatus(
  [out] LPSYSTEM_POWER_STATUS lpSystemPowerStatus
);

Parâmetros

[out] lpSystemPowerStatus

Um ponteiro para uma estrutura SYSTEM_POWER_STATUS que recebe informações status.

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

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

Requisito Valor
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento de energia

SYSTEM_POWER_STATUS

Status de Energia do Sistema