GetCurrentPowerPolicies-Funktion (powrprof.h)

Ruft die aktuellen Systemenergierichtlinieneinstellungen ab.

Syntax

BOOLEAN GetCurrentPowerPolicies(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [out] PPOWER_POLICY        pPowerPolicy
);

Parameter

[out] pGlobalPowerPolicy

Ein Zeiger auf eine GLOBAL_POWER_POLICY Struktur, die die aktuellen globalen Energierichtlinieneinstellungen empfängt.

[out] pPowerPolicy

Ein Zeiger auf eine POWER_POLICY-Struktur , die die Energierichtlinieneinstellungen empfängt, die für das aktive Energieschema eindeutig sind.

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

Um die aktuellen Energierichtlinieneinstellungen zu aktualisieren, rufen Sie die Funktionen WriteGlobalPwrPolicy oder WritePwrScheme auf.

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

GLOBAL_POWER_POLICY

POWER_POLICY

Energieverwaltungsfunktionen

Energieschemas

WriteGlobalPwrPolicy

WritePwrScheme