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


Функция RefreshPolicyEx (userenv.h)

Функция RefreshPolicyEx приводит к немедленному применению политики на компьютере. Расширенная функция позволяет указать тип обновления политики для применения.

Синтаксис

USERENVAPI BOOL RefreshPolicyEx(
  [in] BOOL  bMachine,
  [in] DWORD dwOptions
);

Параметры

[in] bMachine

Указывает, следует ли обновить политику компьютера или политику пользователя. Если это значение равно TRUE, система обновляет политику компьютера. Если это значение равно FALSE, система обновляет политику пользователя.

[in] dwOptions

Указывает тип обновления политики для применения. Этот параметр может иметь следующее значение.

RP_FORCE

Повторно примените все политики, даже если изменения политики не обнаружены.

Обратите внимание, что при наличии каких-либо клиентских расширений, которые можно применить во время загрузки или входа (например, при установке приложения), расширения повторно применяются при следующей загрузке или входе в систему, даже если изменение политики не обнаружено.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Если указывать параметр dwOptions не требуется, можно вызвать функцию RefreshPolicy .

По умолчанию политика повторно применяется каждые 90 минут.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header userenv.h
Библиотека Userenv.lib
DLL Userenv.dll

См. также раздел

Функции групповая политика

Обзор групповых политик

ProcessGroupPolicy

ProcessGroupPolicyEx

RefreshPolicy