Lire en anglais

Partager via

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

  • Article

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

Voir aussi

GetOptions

interfaces stratégie de groupe

Vue d’ensemble de la stratégie de groupe

IGroupPolicyObject