Fonction PowerClearRequest (winbase.h)

Décrémente le nombre de demandes d’alimentation du type spécifié pour un objet power request.

Syntaxe

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

[in] PowerRequest

Handle d’un objet power request.

[in] RequestType

Type de demande d’alimentation à décrémenter. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
PowerRequestDisplayRequiredred	L’affichage reste activé même s’il n’y a pas d’entrée utilisateur pendant une période prolongée.
PowerRequestSystemRequiredred	Le système continue à s’exécuter au lieu d’entrer en veille après une période d’inactivité de l’utilisateur.
PowerRequestAwayModeRequiredred	Le système passe en mode absent au lieu de la veille. En mode absent, le système continue de fonctionner, mais désactive l’audio et la vidéo pour donner l’apparence de veille.
PowerRequestExecutionRequiredred	Le processus appelant continue à s’exécuter au lieu d’être suspendu ou arrêté par les mécanismes de gestion de la durée de vie du processus. Le moment et la durée d’exécution du processus dépendent des paramètres du système d’exploitation et de la stratégie d’alimentation. Lorsqu’une requête PowerRequestExecutionRequired est active, cela implique PowerRequestSystemRequired. Le type de requête PowerRequestExecutionRequired ne peut être utilisé que par les applications. Les services ne peuvent pas utiliser ce type de requête. Windows 7 et Windows Server 2008 R2 : Ce type de requête est pris en charge en commençant par Windows 8 et Windows Server 2012.

Si la fonction réussit, elle retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll