Fonction ReadGlobalPwrPolicy (powrprof.h)

  • Article

[ReadGlobalPwrPolicy 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 actuels de la stratégie d’alimentation globale.

Syntaxe

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Paramètres

[out] pGlobalPowerPolicy

Pointeur vers une structure GLOBAL_POWER_POLICY qui reçoit les informations.

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

La structure GLOBAL_POWER_POLICY contient des paramètres de stratégie communs à tous les schémas d’alimentation. Cette structure contient les paramètres de stratégie utilisateur et ordinateur.

À 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

Voir aussi

GLOBAL_POWER_POLICY

Fonctions de gestion de l’alimentation

WriteGlobalPwrPolicy