Partager via


Fonction EnumPwrSchemes (powrprof.h)

[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