Freigeben über

PowerSettingAccessCheckEx-Funktion (powrprof.h)

  • Artikel

Abfragen für eine Gruppenrichtlinie setzen die angegebenen Energieeinstellungen außer Kraft und geben den angeforderten Zugriff für die Einstellung an.

Syntax

DWORD PowerSettingAccessCheckEx(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid,
  [in]           REGSAM              AccessType
);

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.

[in] AccessType

Der Typ des Sicherheitszugriffs für die Einstellung. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel.

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
KEY_READ
 Kombiniert die Werte STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS und KEY_NOTIFY.
KEY_WRITE
 Kombiniert die Zugriffsrechte STANDARD_RIGHTS_WRITE, KEY_SET_VALUE und KEY_CREATE_SUB_KEY.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile powrprof.h
Bibliothek Powrprof.lib
DLL Powrprof.dll