Partager via


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

Paramètres

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

Valeur retournée

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.

Configuration requise

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

Voir aussi

PowerCreateRequest

PowerSetRequest