Fonction PowerWriteFriendlyName (powrprof.h)

Article
03/01/2024

Définit le nom convivial du paramètre d’alimentation, du sous-groupe ou du schéma spécifié. Si le paramètre SchemeGuid n’a pas la valeur NULL , mais que les paramètres SubGroupOfPowerSettingsGuid et PowerSettingGuid ont tous deux la valeur NULL, le nom convivial du schéma d’alimentation est défini. Si les paramètres SchemeGuid et SubGroupOfPowerSettingsGuid ne sont pas NULL et que le paramètre PowerSettingGuid a la valeur NULL, le nom convivial du sous-groupe est défini. Si les paramètres SchemeGuid, SubGroupOfPowerSettingsGuid et PowerSettingGuid ne sont pas NULL, le nom convivial du paramètre d’alimentation est défini.

Syntaxe

DWORD PowerWriteFriendlyName(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

Paramètres

[in, optional] RootPowerKey

Ce paramètre est réservé pour une utilisation ultérieure et doit être défini sur NULL.

[in] SchemeGuid

Identificateur du schéma d’alimentation.

[in, optional] SubGroupOfPowerSettingsGuid

Sous-groupe des paramètres d’alimentation. Ce paramètre peut être l’une des valeurs suivantes définies dans WinNT.h. Utilisez NO_SUBGROUP_GUID pour faire référence au schéma d’alimentation par défaut.

Valeur	Signification
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Les paramètres de ce sous-groupe font partie du schéma d’alimentation par défaut.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	Les paramètres de ce sous-groupe contrôlent la configuration de la gestion de l’alimentation des lecteurs de disque dur du système.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Les paramètres de ce sous-groupe contrôlent la configuration des boutons d’alimentation système.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Les paramètres de ce sous-groupe contrôlent la configuration des fonctionnalités de gestion de l’alimentation du processeur.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Les paramètres de ce sous-groupe contrôlent la configuration des fonctionnalités de gestion de l’alimentation vidéo.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Les paramètres de ce sous-groupe contrôlent les points de déclenchement et les actions de l’alarme de batterie.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Les paramètres de ce sous-groupe contrôlent les paramètres de veille système.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Les paramètres de ce sous-groupe contrôlent les paramètres PCI Express.

[in, optional] PowerSettingGuid

Identificateur du paramètre d’alimentation.

[in] Buffer

Nom convivial, en caractères larges (Unicode).

[in] BufferSize

Taille du nom convivial spécifié par le paramètre Buffer , y compris le caractère NULL de fin.

Valeur retournée

Retourne ERROR_SUCCESS (zéro) si l’appel a réussi, et une valeur différente de zéro si l’appel a échoué.

Remarques

Les modifications apportées aux paramètres du schéma d’alimentation actif ne prennent pas effet tant que vous n’appelez pas la fonction PowerSetActiveScheme .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	powrprof.h
Bibliothèque	PowrProf.lib
DLL	PowrProf.dll

Voir aussi

Fonctions de gestion de l’alimentation

Partager via