Fonction SetActivePwrScheme (powrprof.h)

Article
08/25/2023

[SetActivePwrScheme est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Les applications écrites pour Windows Vista et versions ultérieures doivent utiliser PowerSetActiveScheme à la place.]

Définit le schéma d’alimentation actif.

Syntaxe

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

Paramètres

[in] uiID

Index du schéma d’alimentation à activer.

[in, optional] pGlobalPowerPolicy

Pointeur vers une structure de GLOBAL_POWER_POLICY facultative, qui fournit des paramètres de stratégie d’alimentation globale à fusionner avec le schéma d’alimentation lorsqu’il devient actif.

[in, optional] pPowerPolicy

Pointeur vers une structure de POWER_POLICY facultative, qui fournit les paramètres de stratégie d’alimentation à fusionner avec le schéma d’alimentation lorsqu’il devient actif.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Utilisez cette fonction pour apporter des modifications à long terme à la configuration système. Pour maintenir temporairement le système en cours d’exécution pendant qu’une application exécute une tâche, utilisez la fonction SetThreadExecutionState .

Si le schéma d’alimentation spécifié par uiID n’existe pas, la fonction retourne zéro.

Si lpGlobalPowerPolicy a la valeur NULL, la fonction utilise les paramètres de stratégie d’alimentation globale actuels définis par WriteGlobalPwrPolicy. Dans le cas contraire, les paramètres de la structure spécifiée remplacent les paramètres de stratégie d’alimentation globale actuels.

Si lpPowerPolicy a la valeur NULL, la fonction utilise les paramètres de stratégie d’alimentation actuels pour le schéma d’alimentation. Dans le cas contraire, les paramètres de la structure spécifiée remplacent les paramètres actuels de la stratégie d’alimentation.

Pour plus d’informations sur l’utilisation de PowrProf.h, consultez Power Schemes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	powrprof.h
Bibliothèque	PowrProf.lib
DLL	PowrProf.dll