nf-powrprof-powersettingaccesscheck.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:powrprof.PowerSettingAccessCheck	PowerSettingAccessCheck function (powrprof.h)	Queries for a group policy override for specified power settings.	ACCESS_ACTIVE_SCHEME ACCESS_AC_POWER_SETTING_INDEX ACCESS_CREATE_SCHEME ACCESS_DC_POWER_SETTING_INDEX ACCESS_SCHEME PowerSettingAccessCheck PowerSettingAccessCheck function base.powersettingaccesscheck powrprof/PowerSettingAccessCheck	base\powersettingaccesscheck.htm	base	0b89c189-b162-44d4-aa50-d78385e40c27	12/05/2018	ACCESS_ACTIVE_SCHEME, ACCESS_AC_POWER_SETTING_INDEX, ACCESS_CREATE_SCHEME, ACCESS_DC_POWER_SETTING_INDEX, ACCESS_SCHEME, PowerSettingAccessCheck, PowerSettingAccessCheck function, base.powersettingaccesscheck, powrprof/PowerSettingAccessCheck	powrprof.h		Windows	Windows Vista [desktop apps only]	Windows Server 2008 [desktop apps only]										PowrProf.lib	PowrProf.dll		Windows			19H1	PowerSettingAccessCheck powrprof/PowerSettingAccessCheck	c++	APIRef kbSyntax	DllExport	PowrProf.dll	PowerSettingAccessCheck

PowerSettingAccessCheck function

-description

Queries for a group policy override for specified power settings.

-parameters

-param AccessFlags [in]

The type of access to check for group policy overrides.

Value	Meaning
ACCESS_AC_POWER_SETTING_INDEX 0 (0x0)	Check for overrides on AC power settings.
ACCESS_DC_POWER_SETTING_INDEX 1 (0x1)	Check for overrides on DC power settings.
ACCESS_SCHEME 16 (0x10)	Check for restrictions on specific power schemes.
ACCESS_ACTIVE_SCHEME 19 (0x13)	Check for restrictions on active power schemes.
ACCESS_CREATE_SCHEME 20 (0x14)	Check for restrictions on creating or restoring power schemes.

-param PowerGuid [in, optional]

The identifier of the power setting.

-returns

Returns ERROR_SUCCESS (zero) if the call was successful, and a nonzero value if the call failed.

Return code/value	Description
ERROR_SUCCESS 0 (0x0)	The specified power setting is not currently overridden by a group policy.
ERROR_ACCESS_DISABLED_BY_POLICY 1260 (0x4EC)	This program is blocked by group policy. For more information, contact your system administrator.
ERROR_INSTALL_REMOTE_DISALLOWED 1640 (0x668)	Only Administrators can remotely access power settings.

-see-also

POWER_DATA_ACCESSOR

Power Management Functions