Compartir a través de


Función PowerClearRequest (winbase.h)

Disminuye el recuento de solicitudes de energía del tipo especificado para un objeto de solicitud de energía.

Sintaxis

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

Parámetros

[in] PowerRequest

Identificador de un objeto de solicitud de energía.

[in] RequestType

Tipo de solicitud de energía que se va a disminuir. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
PowerRequestDisplayRequired
La pantalla permanece activada aunque no haya ninguna entrada de usuario durante un período de tiempo prolongado.
PowerRequestSystemRequired
El sistema continúa ejecutándose en lugar de entrar en suspensión después de un período de inactividad del usuario.
PowerRequestAwayModeRequired
El sistema entra en modo de distancia en lugar de suspensión. En el modo de distancia, el sistema continúa ejecutándose, pero desactiva el audio y el vídeo para dar la apariencia del sueño.
PowerRequestExecutionRequired
El proceso de llamada continúa ejecutándose en lugar de suspenderse o finalizarse mediante mecanismos de administración de duración del proceso. Cuando y cuánto tiempo se permite que el proceso se ejecute depende de la configuración del sistema operativo y de la directiva de energía.

Cuando una solicitud PowerRequestExecutionRequired está activa, implica PowerRequestSystemRequired.

Las aplicaciones solo pueden usar el tipo de solicitud PowerRequestExecutionRequired . Los servicios no pueden usar este tipo de solicitud.

Windows 7 y Windows Server 2008 R2: Este tipo de solicitud se admite a partir de Windows 8 y Windows Server 2012.

Valor devuelto

Si la función se ejecuta correctamente, devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

PowerCreateRequest

PowerSetRequest