IGroupPolicyObject::OpenRemoteMachineGPO method (gpedit.h)

The OpenRemoteMachineGPO method opens the default GPO for the specified remote computer and optionally loads the registry information.

Syntax

HRESULT OpenRemoteMachineGPO(
  [in] LPOLESTR pszComputerName,
  [in] DWORD    dwFlags
);

Parameters

[in] pszComputerName

Specifies the name of the computer. The format of the name is \\ComputerName.

[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 retrieve the computer name of a remote GPO, you can call the GetMachineName method. Call OpenLocalMachineGPO to open the default GPO for a local computer.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header gpedit.h
DLL Gpedit.dll

See also

GetMachineName

Group Policy Interfaces

Group Policy Overview

IGroupPolicyObject

OpenLocalMachineGPO