PowerSettingAccessCheck-Funktion (powrprof.h)

Abfragen für eine Gruppenrichtlinienüberschreibung für angegebene Energieeinstellungen.

Syntax

DWORD PowerSettingAccessCheck(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid
);

Parameter

[in] AccessFlags

Der Typ des Zugriffs, der auf Gruppenrichtlinienüberschreibungen überprüft werden soll.

Wert Bedeutung
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
Überprüfen Sie, ob die Netzstromeinstellungen außer Kraft gesetzt werden.
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
Überprüfen Sie, ob die Dc-Energieeinstellungen außer Kraft gesetzt werden.
ACCESS_SCHEME
16 (0x10)
Überprüfen Sie, ob einschränkungen für bestimmte Energieschemas gelten.
ACCESS_ACTIVE_SCHEME
19 (0x13)
Überprüfen Sie, ob die Aktiven Energieschemas eingeschränkt sind.
ACCESS_CREATE_SCHEME
20 (0x14)
Überprüfen Sie, ob Einschränkungen beim Erstellen oder Wiederherstellen von Energieschemas bestehen.

[in, optional] PowerGuid

Der Bezeichner der Energieeinstellung.

Rückgabewert

Gibt ERROR_SUCCESS (null) zurück, wenn der Aufruf erfolgreich war, und einen Wert ungleich null, wenn der Aufruf fehlgeschlagen ist.

Rückgabecode/-wert BESCHREIBUNG
ERROR_SUCCESS
0 (0x0)
Die angegebene Energieeinstellung wird derzeit nicht von einer Gruppenrichtlinie überschrieben.
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
Dieses Programm wird durch eine Gruppenrichtlinie blockiert. Wenden Sie sich an den Systemadministrator, um weitere Informationen zu erhalten.
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
Nur Administratoren können remote auf Energieeinstellungen zugreifen.

Anforderungen

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

Weitere Informationen

POWER_DATA_ACCESSOR

Energieverwaltungsfunktionen