IGroupPolicyObject ::OpenRemoteMachineGPO, méthode (gpedit.h)

Article
02/29/2024

La méthode OpenRemoteMachineGPO ouvre l’objet de stratégie de groupe par défaut pour l’ordinateur distant spécifié et charge éventuellement les informations du Registre.

Syntaxe

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

Paramètres

[in] pszComputerName

Spécifie le nom de l'ordinateur. Le format du nom est \\ComputerName.

[in] dwFlags

Spécifie si les informations du Registre doivent être chargées pour l’objet de stratégie de groupe. Ce paramètre peut prendre les valeurs suivantes.

GPO_OPEN_LOAD_REGISTRY

Chargez les informations du Registre.

GPO_OPEN_READ_ONLY

Ouvrez l’objet de stratégie de groupe en mode lecture seule.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans le fichier d’en-tête du KIT de développement logiciel (SDK) de plateforme WinError.h.

Remarques

Pour récupérer le nom d’ordinateur d’un objet de stratégie de groupe distant, vous pouvez appeler la méthode GetMachineName . Appelez OpenLocalMachineGPO pour ouvrir l’objet de stratégie de groupe par défaut pour un ordinateur local.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	gpedit.h
DLL	Gpedit.dll