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

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

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.

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