PowerEnumerate-Funktion (powrprof.h)

Listet die angegebenen Elemente in einem Energieschema auf. Diese Funktion wird normalerweise in einer Schleife aufgerufen, die den Index-Parameter erhöht, um Unterschlüssel abzurufen, bis sie alle aufgelistet wurden.

Syntax

DWORD PowerEnumerate(
  [in, optional]  HKEY                RootPowerKey,
  [in, optional]  const GUID          *SchemeGuid,
  [in, optional]  const GUID          *SubGroupOfPowerSettingsGuid,
  [in]            POWER_DATA_ACCESSOR AccessFlags,
  [in]            ULONG               Index,
  [out, optional] UCHAR               *Buffer,
  [in, out]       DWORD               *BufferSize
);

Parameter

[in, optional] RootPowerKey

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

[in, optional] SchemeGuid

Der Bezeichner des Energieschemas. Wenn dieser Parameter NULL ist, wird eine Enumeration der Energierichtlinien zurückgegeben.

[in, optional] SubGroupOfPowerSettingsGuid

Die Untergruppe der Energieeinstellungen. Wenn dieser Parameter NULL ist, wird eine Enumeration von Einstellungen unter dem PolicyGuid-Schlüssel zurückgegeben.

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 Netzschalter des Systems.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Einstellungen in dieser Untergruppe steuern die Konfiguration der Prozessorleistungsverwaltungsfeatures.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Einstellungen in dieser Untergruppe steuern die Konfiguration der Videoenergieverwaltungsfeatures.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Die Einstellungen in dieser Untergruppe steuern Batteriealarmauslöserpunkte und -aktionen.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Einstellungen in dieser Untergruppe steuern die Einstellungen für den Ruhezustand des Systems.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Einstellungen in dieser Untergruppe steuern PCI Express-Einstellungen.

[in] AccessFlags

Ein Satz von Flags, der angibt, was aufgezählt wird.

Wert	Bedeutung
ACCESS_SCHEME 16	Aufzählen von Energieschemas. Die Parameter SchemeGuid und SubgroupOfPowerSettingsGuid werden ignoriert.
ACCESS_SUBGROUP 17	Auflisten von Untergruppen unter SchemeGuid. Der SubgroupOfPowerSettingsGuid-Parameter wird ignoriert.
ACCESS_INDIVIDUAL_SETTING 18	Listen Sie einzelne Energieeinstellungen unter SchemeGuid\SubgroupOfPowerSettingsGuid auf. Um Energieeinstellungen direkt unter der SchemeGuid-Taste aufzulisten, verwenden Sie NO_SUBGROUP_GUID als SubgroupOfPowerSettingsGuid-Parameter .

[in] Index

Der nullbasierte Index des Schemas, der Untergruppe oder der Einstellung, die aufgezählt wird.

[out, optional] Buffer

Ein Zeiger auf eine Variable, die die Elemente empfangen soll. Wenn dieser Parameter NULL ist, ruft die Funktion die Größe des erforderlichen Puffers ab.

[in, out] BufferSize

Ein Zeiger auf eine Variable, die bei der Eingabe die Größe des Puffers enthält, auf den der Buffer-Parameter verweist. Wenn der Buffer-ParameterNULL ist oder bufferSize nicht groß genug ist, gibt die Funktion ERROR_MORE_DATA zurück, und die Variable empfängt die erforderliche Puffergröße.

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ungleich null, wenn der Aufruf fehlgeschlagen ist. Wenn die im BufferSize-Parameter übergebene Puffergröße zu klein ist oder der Buffer-ParameterNULL ist, wird ERROR_MORE_DATA zurückgegeben, und das DWORD , auf das der BufferSize-Parameter verweist, wird mit der erforderlichen Puffergröße ausgefüllt.

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

POWER_DATA_ACCESSOR

Energieverwaltungsfunktionen