Функция SaferSetPolicyInformation (winsafer.h)

Статья
08/27/2023

Функция SaferSetPolicyInformation задает элементы управления глобальной политикой.

Синтаксис

BOOL SaferSetPolicyInformation(
  [in] DWORD                   dwScopeId,
  [in] SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in] DWORD                   InfoBufferSize,
  [in] PVOID                   InfoBuffer,
       LPVOID                  lpReserved
);

Параметры

[in] dwScopeId

Область запроса. В следующей таблице приводятся возможные значения.

Значение	Значение
SAFER_SCOPEID_MACHINE 1	Область запроса выполняется по компьютерам.
SAFER_SCOPEID_USER 2	Область запроса — пользователь.

[in] SaferPolicyInfoClass

Значение перечисления SAFER_POLICY_INFO_CLASS , указывающее тип сведений о политике, которые должны быть заданы. Указанное значение определяет размер и тип параметра InfoBuffer . В следующей таблице приводятся возможные значения.

Значение	Значение
SaferPolicyLevelList 1	Задает список всех уровней, определенных в политике. Тип возвращаемого значения InfoBuffer: массив DWORD levelIds.
SaferPolicyEnableTransparentEnforcement 2	Задает значение политики, чтобы определить, включена ли проверка DLL. Тип возвращаемого значения InfoBuffer: логическое значение DWORD.
SaferPolicyDefaultLevel 3	Задает уровень политики по умолчанию. Тип возвращаемого значения InfoBuffer: DWORD LevelId.
SaferPolicyEvaluateUserScope 4	Задает, следует ли обращаться к правилам область пользователей во время оценки политики. Тип возвращаемого значения InfoBuffer: DWORD.
SaferPolicyScopeFlags 5	Задает, должна ли политика пропускать участников группы локальных администраторов. Тип возвращаемого значения InfoBuffer: DWORD.

[in] InfoBufferSize

Размер параметра InfoBuffer в байтах.

[in] InfoBuffer

Буфер, содержащий результаты запроса. Размер и тип возвращаемых сведений определяется параметром SaferPolicyInfoClass . Тип возвращаемых сведений для каждого возможного значения параметра SaferPolicyInfoClass см. в разделе Параметр SaferPolicyInfoClass .

lpReserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.

Возвращаемое значение

Значение TRUE , если функция выполнена успешно; в противном случае — FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	winsafer.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll
Набор API	ext-ms-win-advapi32-safer-l1-1-0 (представлено в Windows 8)

Share via