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

Статья
08/27/2023

Функция SaferGetPolicyInformation получает сведения о политике. Вы можете запросить дополнительные сведения о политике.

Синтаксис

BOOL SaferGetPolicyInformation(
  [in]  DWORD                   dwScopeId,
  [in]  SAFER_POLICY_INFO_CLASS SaferPolicyInfoClass,
  [in]  DWORD                   InfoBufferSize,
  [out] PVOID                   InfoBuffer,
  [out] PDWORD                  InfoBufferRetSize,
        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 в байтах.

[out] InfoBuffer

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

[out] InfoBufferRetSize

Количество байтов в параметре InfoBuffer , которые были заполнены сведениями о политике.

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)

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