ReadGlobalPwrPolicy-Funktion (powrprof.h)

[ReadGlobalPwrPolicy 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. Siehe Hinweise.]

Ruft die aktuellen Global Power Policy-Einstellungen ab.

Syntax

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Parameter

[out] pGlobalPowerPolicy

Ein Zeiger auf eine GLOBAL_POWER_POLICY Struktur, die die Informationen 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

Die GLOBAL_POWER_POLICY-Struktur enthält Richtlinieneinstellungen, die allen Energieschemas gemeinsam sind. Diese Struktur enthält sowohl Benutzer- als auch Computerrichtlinieneinstellungen.

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

GLOBAL_POWER_POLICY

Energieverwaltungsfunktionen

WriteGlobalPwrPolicy