EnumPwrSchemes-Funktion (powrprof.h)

[EnumPwrSchemes ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Anwendungen, die für Windows Vista und höher geschrieben wurden, sollten stattdessen PowerEnumerate verwenden.]

Listet alle Machtschemas auf. Für jedes aufgezählte Energieschema ruft die Funktion eine Rückruffunktion mit Informationen zum Energieschema auf.

Syntax

BOOLEAN EnumPwrSchemes(
  [in] PWRSCHEMESENUMPROC lpfn,
  [in] LPARAM             lParam
);

Parameter

[in] lpfn

Ein Zeiger auf eine Rückruffunktion, die für jedes aufgezählte Energieschema aufgerufen werden soll. Weitere Informationen finden Sie in den Hinweisen.

[in] lParam

Ein benutzerdefinierter Wert, der an die Rückruffunktion übergeben werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Für jedes aufgezählte Energieschema wird die Rückruffunktion mit den folgenden Parametern aufgerufen:

typedef BOOLEAN (CALLBACK* PWRSCHEMESENUMPROC)(
  UINT uiIndex,      // power scheme index
  DWORD dwName,      // size of the sName string, in bytes
  LPWSTR sName,      // name of the power scheme
  DWORD dwDesc,      // size of the sDesc string, in bytes
  LPWSTR sDesc,      // description string
  PPOWER_POLICY pp,  // receives the power policy
  LPARAM lParam      // user-defined value
);

Die Parameter sName und sDesc sind Unicode-Zeichenfolgen mit Null-Beendigung. Der pp-Parameter ist ein Zeiger auf eine POWER_POLICY Struktur, die das Energierichtlinienschema enthält. Um fortzufahren, bis alle Energieschemas aufgelistet wurden, muss die Rückruffunktion TRUE zurückgeben. Um die Enumeration zu beenden, muss die Rückruffunktion FALSE zurückgeben.

Weitere Informationen zur Verwendung von PowrProf.h finden Sie unter Energieschemas.

Anforderungen

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

Weitere Informationen

POWER_POLICY

Energieverwaltungsfunktionen

Energieschemas