Fonction EnumPwrSchemes (powrprof.h)

Article
03/06/2024

[EnumPwrSchemes 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 PowerEnumerate à la place.]

Énumère tous les schémas d’alimentation. Pour chaque schéma d’alimentation énuméré, la fonction appelle une fonction de rappel avec des informations sur le schéma d’alimentation.

Syntaxe

BOOLEAN EnumPwrSchemes(
  [in] PWRSCHEMESENUMPROC lpfn,
  [in] LPARAM             lParam
);

Paramètres

[in] lpfn

Pointeur vers une fonction de rappel à appeler pour chaque schéma d’alimentation énuméré. Pour plus d'informations, consultez la section Notes.

[in] lParam

Valeur définie par l’utilisateur à passer à la fonction de rappel.

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

Pour chaque schéma d’alimentation énuméré, la fonction de rappel est appelée avec les paramètres suivants :


typedef BOOLEAN (CALLBACK* PWRSCHEMESENUMPROC)(
  UINT uiIndex,      // power scheme index
  DWORD dwName,      // size of the sName string, in bytes
  LPWSTR sName,      // name of the power scheme
  DWORD dwDesc,      // size of the sDesc string, in bytes
  LPWSTR sDesc,      // description string
  PPOWER_POLICY pp,  // receives the power policy
  LPARAM lParam      // user-defined value
);

Les paramètres sName et sDesc sont des chaînes Unicode terminées par un caractère Null. Le paramètre pp est un pointeur vers une structure POWER_POLICY contenant le schéma de stratégie d’alimentation. Pour continuer jusqu’à ce que tous les schémas d’alimentation aient été énumérés, la fonction de rappel doit retourner TRUE. Pour arrêter l’énumération, la fonction de rappel doit retourner FALSE.

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

POWER_POLICY

Fonctions de gestion de l’alimentation

Schémas d’alimentation

Partager via