Função PowerClearRequest (winbase.h)

Diminui a contagem de solicitações de energia do tipo especificado para um objeto de solicitação de energia.

Sintaxe

BOOL PowerClearRequest(
  [in] HANDLE             PowerRequest,
  [in] POWER_REQUEST_TYPE RequestType
);

[in] PowerRequest

Um identificador para um objeto de solicitação de energia.

[in] RequestType

O tipo de solicitação de energia a ser decrementado. Esse parâmetro pode usar um dos valores a seguir.

Valor	Significado
PowerRequestDisplayRequired	A exibição permanecerá ativada mesmo que não haja nenhuma entrada do usuário por um longo período de tempo.
PowerRequestSystemRequired	O sistema continua a ser executado em vez de entrar em suspensão após um período de inatividade do usuário.
PowerRequestAwayModeRequired	O sistema entra no modo de suspensão em vez de suspensão. No modo ausente, o sistema continua a ser executado, mas desativa o áudio e o vídeo para dar a aparência de suspensão.
PowerRequestExecutionRequired	O processo de chamada continua a ser executado em vez de ser suspenso ou encerrado por mecanismos de gerenciamento de tempo de vida do processo. Quando e quanto tempo o processo tem permissão para ser executado depende das configurações do sistema operacional e da política de energia. Quando uma solicitação PowerRequestExecutionRequired está ativa, ela implica PowerRequestSystemRequired. O tipo de solicitação PowerRequestExecutionRequired só pode ser usado por aplicativos. Os serviços não podem usar esse tipo de solicitação. Windows 7 e Windows Server 2008 R2: Esse tipo de solicitação tem suporte começando com Windows 8 e Windows Server 2012.

Se a função for bem-sucedida, ela retornará um valor diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Esta página foi útil?