IGroupPolicyObject::New method (gpedit.h)

The New method creates a new GPO in the Active Directory with the specified display name. The method opens the GPO using the OpenDSGPO method.

Syntax

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

Parameters

[in] pszDomainName

Specifies the Active Directory path of the object to create. If the path specifies a domain controller, the GPO is created on that DC. Otherwise, the system will select a DC on the caller's behalf.

[in] pszDisplayName

Specifies the display name of the object to create.

[in] dwFlags

Specifies whether or not the registry information should be loaded for the GPO. This parameter can be one of the following values.

GPO_OPEN_LOAD_REGISTRY

Load the registry information.

GPO_OPEN_READ_ONLY

Open the GPO in read-only mode.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in the Platform SDK header file WinError.h.

Remarks

To open a GPO that already exists, you can call the OpenDSGPO method.

Requirements

See also

Group Policy Interfaces

Group Policy Overview

IGroupPolicyObject

OpenDSGPO