powerSettingAccessCheck 函数 (powrprof.h)

查询指定电源设置的组策略替代。

语法

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

parameters

[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

电源设置的标识符。

返回值

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

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

要求

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

请参阅

POWER_DATA_ACCESSOR

电源管理功能