Fonction ReadPwrScheme (powrprof.h)

Article
03/04/2024

[ReadPwrScheme 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. Voir Remarques.]

Récupère les paramètres de stratégie d’alimentation qui sont propres au schéma d’alimentation spécifié.

Syntaxe

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

Paramètres

[in] uiID

Index du schéma d’alimentation à lire.

[out] pPowerPolicy

Pointeur vers une structure de POWER_POLICY qui reçoit les paramètres de stratégie d’alimentation.

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

Si le schéma d’alimentation spécifié n’existe pas, la fonction retourne FALSE.

Pour récupérer des informations sur les paramètres de stratégie d’alimentation actuellement utilisés par le système, appelez la fonction GetActivePwrScheme . Pour récupérer des informations supplémentaires sur les paramètres actuels de la stratégie d’alimentation, appelez la fonction CallNtPowerInformation .

À compter de Windows Vista, utilisez la fonction PowerEnumerate pour énumérer les paramètres d’alimentation d’un schéma spécifié et les fonctions power read pour récupérer des paramètres individuels.

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