IGroupPolicyObject::OpenRemoteMachineGPO method (gpedit.h)

Article
2024-02-22

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

Share via