PowerWriteFriendlyName-Funktion (powrprof.h)

  • Artikel

Legt den Anzeigenamen für die angegebene Energieeinstellung, Untergruppe oder das angegebene Schema fest. Wenn der SchemeGuid-Parameter nicht NULL ist, sondern sowohl die Parameter SubGroupOfPowerSettingsGuid als auch PowerSettingGuidNULL sind, wird der Anzeigename des Energieschemas festgelegt. Wenn die Parameter SchemeGuid und SubGroupOfPowerSettingsGuid nicht NULL und der PowerSettingGuid-ParameterNULL ist, wird der Anzeigename der Untergruppe festgelegt. Wenn die Parameter SchemeGuid, SubGroupOfPowerSettingsGuid und PowerSettingGuid nicht NULL sind, wird der Anzeigename der Energieeinstellung festgelegt.

Syntax

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
);

Parameter

[in, optional] RootPowerKey

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf NULL festgelegt werden.

[in] SchemeGuid

Der Bezeichner des Energieschemas.

[in, optional] SubGroupOfPowerSettingsGuid

Die Untergruppe der Energieeinstellungen. Dieser Parameter kann einer der folgenden Werte sein, die in WinNT.h definiert sind. Verwenden Sie NO_SUBGROUP_GUID , um auf das Standardenergieschema zu verweisen.

Wert Bedeutung
NO_SUBGROUP_GUID
fea3413e-7e05-4911-9a71-700331f1c294
 Einstellungen in dieser Untergruppe sind Teil des Standardenergieschemas.
GUID_DISK_SUBGROUP
0012ee47-9041-4b5d-9b77-535fba8b1442
 Einstellungen in dieser Untergruppe steuern die Energieverwaltungskonfiguration der Festplattenlaufwerke des Systems.
GUID_SYSTEM_BUTTON_SUBGROUP
4f971e89-eebd-4455-a8de-9e59040e7347
 Einstellungen in dieser Untergruppensteuerungskonfiguration der Netzschaltflächen des Systems.
GUID_PROCESSOR_SETTINGS_SUBGROUP
54533251-82be-4824-96c1-47b60b740d00
 Einstellungen in dieser Untergruppensteuerungskonfiguration der Prozessorleistungsverwaltungsfunktionen.
GUID_VIDEO_SUBGROUP
7516b95f-f776-4464-8c53-06167f40cc99
 Einstellungen in dieser Untergruppensteuerungskonfiguration der Videoenergieverwaltungsfeatures.
GUID_BATTERY_SUBGROUP
e73a048d-bf27-4f12-9731-8b2076e8891f
 Die Einstellungen in dieser Untergruppe steuern Die Auslösepunkte und Aktionen des Batteriealarms.
GUID_SLEEP_SUBGROUP
238C9FA8-0AAD-41ED-83F4-97BE242C8F20
 Einstellungen in diesen Untergruppensteuerungsmoduseinstellungen.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP
501a4d13-42af-4429-9fd1-a8218c268e20
 Einstellungen in dieser Untergruppe steuern PCI-Express-Einstellungen.

[in, optional] PowerSettingGuid

Der Bezeichner der Energieeinstellung.

[in] Buffer

Der Anzeigename in Breitzeichen (Unicode).

[in] BufferSize

Die Größe des Anzeigenamens, der vom Buffer-Parameter angegeben wird, einschließlich des beendenden NULL-Zeichens .

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ohne Zero, wenn der Aufruf fehlgeschlagen ist.

Hinweise

Änderungen an den Einstellungen für das aktive Energieschema werden erst wirksam, wenn Sie die Funktion PowerSetActiveScheme aufrufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile powrprof.h
Bibliothek PowrProf.lib
DLL PowrProf.dll

Weitere Informationen

Energieverwaltungsfunktionen