IGroupPolicyObject::OpenRemoteMachineGPO-Methode (gpedit.h)

Artikel
02/27/2024

Die OpenRemoteMachineGPO-Methode öffnet das Standard-Gruppenrichtlinienobjekt für den angegebenen Remotecomputer und lädt optional die Registrierungsinformationen.

Syntax

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

Parameter

[in] pszComputerName

Gibt den Namen des Computers an. Das Format des Namens ist \\ComputerName.

[in] dwFlags

Gibt an, ob die Registrierungsinformationen für das Gruppenrichtlinienobjekt geladen werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

GPO_OPEN_LOAD_REGISTRY

Laden Sie die Registrierungsinformationen.

GPO_OPEN_READ_ONLY

Öffnen Sie das Gruppenrichtlinienobjekt im schreibgeschützten Modus.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der COM-Fehlercodes zurück, die in der Platform SDK-Headerdatei WinError.h definiert sind.

Hinweise

Um den Computernamen eines Remote-Gruppenrichtlinienobjekts abzurufen, können Sie die GetMachineName-Methode aufrufen. Rufen Sie OpenLocalMachineGPO auf, um das Standard-Gruppenrichtlinienobjekt für einen lokalen Computer zu öffnen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	gpedit.h
DLL	Gpedit.dll