Funzione PowerWriteFriendlyName (powrprof.h)
Imposta il nome descrittivo per l'impostazione di risparmio energia, il sottogruppo o lo schema specificati. Se il parametro SchemeGuid non è NULL , ma entrambi i parametri SubGroupOfPowerSettingsGuid e PowerSettingGuid sono NULL, verrà impostato il nome descrittivo dello schema di alimentazione. Se i parametri SchemeGuid e SubGroupOfPowerSettingsGuid non sono NULL e il parametro PowerSettingGuid è NULL, verrà impostato il nome descrittivo del sottogruppo. Se i parametri SchemeGuid, SubGroupOfPowerSettingsGuid e PowerSettingGuid non sono NULL, verrà impostato il nome descrittivo dell'impostazione di risparmio energia.
Sintassi
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
);
Parametri
[in, optional] RootPowerKey
Questo parametro è riservato per uso futuro e deve essere impostato su NULL.
[in] SchemeGuid
Identificatore dello schema di alimentazione.
[in, optional] SubGroupOfPowerSettingsGuid
Sottogruppo di impostazioni di risparmio energia. Questo parametro può essere uno dei valori seguenti definiti in WinNT.h. Usare NO_SUBGROUP_GUID per fare riferimento allo schema di alimentazione predefinito.
[in, optional] PowerSettingGuid
Identificatore dell'impostazione di alimentazione.
[in] Buffer
Nome descrittivo, in caratteri Wide (Unicode).
[in] BufferSize
Dimensioni del nome descrittivo specificato dal parametro Buffer , incluso il carattere NULL di terminazione.
Valore restituito
Restituisce ERROR_SUCCESS (zero) se la chiamata ha avuto esito positivo e un valore diverso da zero se la chiamata non è riuscita.
Commenti
Le modifiche apportate alle impostazioni per lo schema di alimentazione attivo non diventano effettive fino a quando non si chiama la funzione PowerSetActiveScheme .
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | powrprof.h |
Libreria | PowrProf.lib |
DLL | PowrProf.dll |