IGroupPolicyObject::OpenDSGPO method

The OpenDSGPO method opens the specified GPO and optionally loads the registry information.

Syntax


HRESULT OpenDSGPO(
  [in] LPOLESTR pszPath,
  [in] DWORD    dwFlags
);

Parameters

pszPath [in]

Specifies the Active Directory path of the object to open. 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.

dwFlags [in]

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 create a new GPO in the Active Directory, you can call the New method.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Gpedit.h

DLL

Gpedit.dll

IID

IID_IGroupPolicyObject is defined as EA502723-A23D-11d1-A7D3-0000F87571E3

See also

Group Policy Overview
Group Policy Interfaces
IGroupPolicyObject
New

 

 

Show: