Fonction WritePwrScheme (powrprof.h)

Article
03/01/2024

[WritePwrScheme n’est plus disponible pour une utilisation à partir de Windows Vista. Au lieu de cela, utilisez la fonction PowerEnumerate pour énumérer les paramètres d’alimentation pour un schéma spécifié, et les fonctions d’écriture d’alimentation pour écrire des paramètres individuels.]

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

Syntaxe

BOOLEAN WritePwrScheme(
  [in]           PUINT         puiID,
  [in]           LPCWSTR       lpszSchemeName,
  [in, optional] LPCWSTR       lpszDescription,
  [in]           PPOWER_POLICY lpScheme
);

Paramètres

[in] puiID

Index du schéma d’alimentation à écrire. Si un schéma d’alimentation avec le même index existe déjà, il est remplacé. Sinon, un nouveau schéma d’alimentation est créé.

[in] lpszSchemeName

Nom du schéma d’alimentation.

[in, optional] lpszDescription

Description du schéma d’alimentation.

[in] lpScheme

Pointeur vers une structure de POWER_POLICY qui contient les paramètres de stratégie d’alimentation à écrire.

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

Cette modification n’affecte pas la stratégie d’alimentation système actuelle. Pour appliquer cette modification à la stratégie d’alimentation système actuelle, appelez la fonction SetActivePwrScheme avec l’index de ce schéma d’alimentation.

Les schémas de stratégie d’alimentation écrits à l’aide de WritePwrScheme sont stockés en permanence dans les ruches du Registre système et restent disponibles pour une utilisation dans le programme du panneau de configuration Power Options ou par des appels ultérieurs à l’API du schéma d’alimentation. Pour supprimer définitivement un schéma d’alimentation du système, appelez la fonction DeletePwrScheme .

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