IGroupPolicyObject::SetOptions 方法 (gpedit.h)

SetOptions 方法设置 GPO 的选项。

语法

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

parameters

[in] dwOptions

指定新选项值。 此参数可以是以下一个或多个选项。 有关更多信息,请参见下面的“备注”部分。

GPO_OPTION_DISABLE_USER

禁用 GPO 的用户部分。

GPO_OPTION_DISABLE_MACHINE

禁用 GPO 的计算机部分。

[in] dwMask

指定要更改的选项。 此参数可以是以下一个或多个选项。 有关更多信息,请参见下面的“备注”部分。

GPO_OPTION_DISABLE_USER

禁用 GPO 的用户部分。

GPO_OPTION_DISABLE_MACHINE

禁用 GPO 的计算机部分。

返回值

如果该方法成功,则 返回值S_OK。 否则,该方法将返回平台 SDK 头文件 WinError.h 中定义的 COM 错误代码之一。

注解

注意当使用 SetOptions 方法启用或禁用本地组策略对象的用户或计算机部分时,将自动触发策略刷新。
 
若要更改选项,必须在 dwMask 参数中设置相应的标志。 如果设置了 标志,则系统会读取 dwOptions 参数以设置新状态。 例如,若要禁用 GPO 的用户部分,并保持计算机部分不变,请调用 SetOptions 方法,如下所示:
SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

若要启用用户部分并禁用计算机部分,请调用 SetOptions 方法,如下所示:

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

若要检索 GPO 的选项,可以调用 GetOptions 方法。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 gpedit.h
DLL Gpedit.dll

另请参阅

GetOptions

组策略接口

组策略概述

IGroupPolicyObject