Поделиться через

Функция 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)
 Проверьте наличие переопределений в параметрах питания постоянного тока.
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