ReadPwrScheme-Funktion (powrprof.h)

[ReadPwrScheme ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Siehe Hinweise.]

Ruft die Energierichtlinieneinstellungen ab, die für das angegebene Energieschema eindeutig sind.

Syntax

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

Parameter

[in] uiID

Der Index des zu lesenden Energieschemas.

[out] pPowerPolicy

Ein Zeiger auf eine POWER_POLICY-Struktur , die die Energierichtlinieneinstellungen empfängt.

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

Wenn das angegebene Energieschema nicht vorhanden ist, gibt die Funktion FALSE zurück.

Um Informationen zu den Energierichtlinieneinstellungen abzurufen, die derzeit vom System verwendet werden, rufen Sie die GetActivePwrScheme-Funktion auf. Rufen Sie die Funktion CallNtPowerInformation auf, um zusätzliche Informationen zu den aktuellen Energierichtlinieneinstellungen abzurufen.

Verwenden Sie ab Windows Vista die PowerEnumerate-Funktion , um Energieeinstellungen für ein angegebenes Schema und die Power Read-Funktionen aufzulisten, um einzelne Einstellungen abzurufen.

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

GetActivePwrScheme

POWER_POLICY

Energieverwaltungsfunktionen

Energieschemas

WritePwrScheme