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 |