Метод IGroupPolicyObject::SetOptions (gpedit.h)

Статья
08/24/2023

Метод SetOptions задает параметры объекта групповой политики.

Синтаксис

HRESULT SetOptions(
  [in] DWORD dwOptions,
  [in] DWORD dwMask
);

Параметры

[in] dwOptions

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

GPO_OPTION_DISABLE_USER

Отключите пользовательская часть объекта групповой политики.

GPO_OPTION_DISABLE_MACHINE

Отключите компьютерную часть объекта групповой политики.

[in] dwMask

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

GPO_OPTION_DISABLE_USER

Отключите пользовательская часть объекта групповой политики.

GPO_OPTION_DISABLE_MACHINE

Отключите компьютерную часть объекта групповой политики.

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

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в файле заголовка пакета SDK для платформы WinError.h.

Примечание Обновление политики будет автоматически активировано при включении или отключении пользовательской или компьютерной части локального объекта групповая политика с помощью метода SetOptions.

Чтобы изменить параметр, необходимо задать соответствующий флаг в параметре dwMask . Если флаг установлен, система считывает параметр dwOptions , чтобы задать новое состояние. Например, чтобы отключить пользовательская часть объекта групповой политики и оставить часть компьютера без изменений, вызовите метод SetOptions следующим образом:

SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

Чтобы включить часть пользователя и отключить часть компьютера, вызовите метод SetOptions следующим образом:

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

Чтобы получить параметры объекта групповой политики, можно вызвать метод GetOptions .

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	gpedit.h
DLL	Gpedit.dll