Функция PowerSettingAccessCheckEx (powrprof.h)

Статья
03/08/2023

Запросы для переопределения групповой политики для указанных параметров питания и указывают запрошенный доступ для параметра.

Синтаксис

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)	Проверьте наличие переопределений в параметрах питания постоянного тока.
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
Header	powrprof.h
Библиотека	Powrprof.lib
DLL	Powrprof.dll

Share via