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

Article
03/02/2024

La méthode Save enregistre les paramètres de stratégie de Registre spécifiés sur le disque et met à jour le numéro de révision de l’objet de stratégie de groupe.

Syntaxe

HRESULT Save(
  [in] BOOL bMachine,
  [in] BOOL bAdd,
  [in] GUID *pGuidExtension,
  [in] GUID *pGuid
);

Paramètres

[in] bMachine

Spécifie les paramètres de stratégie du Registre à enregistrer. Si ce paramètre a la valeur TRUE, les paramètres de stratégie de l’ordinateur sont enregistrés. Sinon, les paramètres de stratégie utilisateur sont enregistrés.

[in] bAdd

Spécifie s’il s’agit d’une opération d’ajout ou de suppression. Si ce paramètre a la valeur FALSE, le dernier paramètre de stratégie pour l’extension pGuidExtension spécifiée est supprimé. Dans tous les autres cas, ce paramètre a la valeur TRUE.

[in] pGuidExtension

Spécifie le GUID ou le nom unique de l’extension de composant logiciel enfichable qui traitera la stratégie. Si l’objet de stratégie de groupe doit être traité par le composant logiciel enfichable qui traite les fichiers .pol, vous devez spécifier la valeur REGISTRY_EXTENSION_GUID.

[in] pGuid

Spécifie le GUID qui identifie le composant logiciel enfichable MMC utilisé pour modifier cette stratégie. Le composant logiciel enfichable peut être un composant logiciel enfichable Microsoft ou un composant logiciel enfichable tiers.

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

Note Une actualisation de stratégie est automatiquement déclenchée lorsque la partie utilisateur ou ordinateur de l’objet stratégie de groupe local est activée ou désactivée à l’aide de la méthode Save.

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

Voir aussi

Supprimer

interfaces stratégie de groupe

Vue d’ensemble de la stratégie de groupe

IGroupPolicyObject

Nouveau

Partager via