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

Article
02/26/2024

La méthode New crée un objet de stratégie de groupe dans Active Directory avec le nom d’affichage spécifié. La méthode ouvre l’objet de stratégie de groupe à l’aide de la méthode OpenDSGPO .

Syntaxe

HRESULT New(
  [in] LPOLESTR pszDomainName,
  [in] LPOLESTR pszDisplayName,
  [in] DWORD    dwFlags
);

Paramètres

[in] pszDomainName

Spécifie le chemin Active Directory de l’objet à créer. Si le chemin d’accès spécifie un contrôleur de domaine, l’objet de stratégie de groupe est créé sur ce contrôleur de domaine. Sinon, le système sélectionne un contrôleur de domaine pour le compte de l’appelant.

[in] pszDisplayName

Spécifie le nom complet de l’objet à créer.

[in] dwFlags

Spécifie si les informations de 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 SDK de plateforme WinError.h.

Remarques

Pour ouvrir un objet de stratégie de groupe qui existe déjà, vous pouvez appeler la méthode OpenDSGPO .

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