Méthode IGroupPolicyObject::SetOptions (gpedit.h)

Article
08/24/2023

La méthode SetOptions définit les options de l’objet de stratégie de groupe.

Syntaxe

HRESULT SetOptions(
  [in] DWORD dwOptions,
  [in] DWORD dwMask
);

Paramètres

[in] dwOptions

Spécifie les nouvelles valeurs d’option. Ce paramètre peut être une ou plusieurs des options suivantes. Pour plus d'informations, consultez la section Notes qui suit.

GPO_OPTION_DISABLE_USER

Désactivez la partie utilisateur de l’objet de stratégie de groupe.

GPO_OPTION_DISABLE_MACHINE

Désactivez la partie ordinateur de l’objet de stratégie de groupe.

[in] dwMask

Spécifie les options à modifier. Ce paramètre peut être une ou plusieurs des options suivantes. Pour plus d'informations, consultez la section Notes qui suit.

GPO_OPTION_DISABLE_USER

Désactivez la partie utilisateur de l’objet de stratégie de groupe.

GPO_OPTION_DISABLE_MACHINE

Désactivez la partie ordinateur de l’objet de stratégie de groupe.

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.

Notes

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 SetOptions.

Pour modifier une option, vous devez définir l’indicateur approprié dans le paramètre dwMask . Si l’indicateur est défini, le système lit le paramètre dwOptions pour définir le nouvel état. Par exemple, pour désactiver la partie utilisateur d’un objet de stratégie de groupe et laisser la partie ordinateur inchangée, appelez la méthode SetOptions comme suit :

SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

Pour activer la partie utilisateur et désactiver la partie ordinateur, appelez la méthode SetOptions comme suit :

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

Pour récupérer les options d’un objet de stratégie de groupe, vous pouvez appeler la méthode GetOptions .

Configuration requise


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