IGroupPolicyObject::New 方法 (gpedit.h)

New 方法使用指定的显示名称在 Active Directory 中创建新的 GPO。 方法使用 OpenDSGPO 方法打开 GPO。

语法

HRESULT New(
  [in] LPOLESTR pszDomainName,
  [in] LPOLESTR pszDisplayName,
  [in] DWORD    dwFlags
);

参数

[in] pszDomainName

指定要创建的对象的 Active Directory 路径。 如果路径指定域控制器,则会在该 DC 上创建 GPO。 否则,系统将代表调用方选择 DC。

[in] pszDisplayName

指定要创建的对象的显示名称。

[in] dwFlags

指定是否应为 GPO 加载注册表信息。 此参数的取值可为下列值之一:

GPO_OPEN_LOAD_REGISTRY

加载注册表信息。

GPO_OPEN_READ_ONLY

在只读模式下打开 GPO。

返回值

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

注解

若要打开已存在的 GPO,可以调用 OpenDSGPO 方法。

要求

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

另请参阅

组策略接口

组策略概述

IGroupPolicyObject

OpenDSGPO