Fonction WritePwrScheme (powrprof.h)
[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 |