Compartilhar via


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
);

Parâmetros

[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.

Retornar valor

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.

Requisitos

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

Confira também

PowerCreateRequest

PowerSetRequest