Compartilhar via


Função PowerCreateRequest (winbase.h)

Cria um novo objeto de solicitação de energia.

Sintaxe

HANDLE PowerCreateRequest(
  [in] PREASON_CONTEXT Context
);

Parâmetros

[in] Context

Aponta para uma estrutura de REASON_CONTEXT que contém informações sobre a solicitação de energia.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador para o objeto de solicitação de energia.

Se houver falha na função, o valor de retorno será INVALID_HANDLE_VALUE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Quando o objeto de solicitação de energia não for mais necessário, use a função CloseHandle para liberar o identificador e limpo o objeto.

Requisitos

   
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

PowerClearRequest

PowerSetRequest