powerSettingAccessCheck 函数 (powrprof.h)

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

语法

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

[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)	只有管理员才能远程访问电源设置。