通过

PowerSettingAccessCheckEx 函数 (powrprof.h)

  • 项目

查询指定电源设置的组策略替代，并指定设置的请求访问权限。

语法

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

参数

[in] AccessFlags

组策略替代对检查的访问类型。

值 含义
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
 检查交流电源设置上的替代。
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
 检查 DC 电源设置上的替代。
ACCESS_SCHEME
16 (0x10)
 检查特定电源方案的限制。
ACCESS_ACTIVE_SCHEME
19 (0x13)
 检查对活动电源方案的限制。
ACCESS_CREATE_SCHEME
20 (0x14)
 检查创建或还原电源方案的限制。

[in, optional] PowerGuid

电源设置的标识符。

[in] AccessType

设置的安全访问类型。 有关详细信息，请参阅 注册表项安全和访问权限。

此参数的取值可为下列值之一：

值 含义
KEY_READ
 合并STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS和KEY_NOTIFY值。
KEY_WRITE
 合并STANDARD_RIGHTS_WRITE、KEY_SET_VALUE和KEY_CREATE_SUB_KEY访问权限。

返回值

如果调用成功，则返回 ERROR_SUCCESS (零) ;如果调用失败，则返回非零值。

返回代码/值 说明
ERROR_SUCCESS
0 (0x0)
 组策略当前未覆盖指定的电源设置。
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
 此程序由组策略阻止。 有关详细信息，请与系统管理员联系。
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
 只有管理员才能远程访问电源设置。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 powrprof.h
Library Powrprof.lib
DLL Powrprof.dll