Méthode SetSecurityDescriptor de la classe __SystemSecurity

La méthode SetSecurityDescriptor écrit une version mise à jour du descripteur de sécurité qui contrôle l’accès à l’espace de noms WMI auquel vous êtes connecté. Le descripteur de sécurité est représenté par une instance de __SecurityDescriptor. Pour plus d’informations, consultez Modification de la sécurité d’accès sur les objets sécurisables.

Syntaxe

uint32 SetSecurityDescriptor(
  [in] __SecurityDescriptor Descriptor
);

Paramètres

Descripteur [in]

Descripteur de sécurité associé à l’espace de noms WMI.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou une valeur différente pour indiquer une erreur. Pour plus d’informations, consultez les codes de retour WMI ou WbemErrorEnum.

0

Réussite.

2

L’utilisateur n’a pas accès aux informations demandées.

8

Échec inconnu.

9

L’utilisateur n’a pas de privilèges adéquats pour exécuter la méthode.

21

Un paramètre spécifié dans l’appel de méthode n’est pas valide.

Remarques

L’instance Win32_SecurityDescriptor représente un type de données SECURITY_DESCRIPTOR_CONTROL et contient une liste de contrôle d’accès discrétionnaire (DACL) et une liste de contrôle d’accès système (SACL). Pour plus d’informations, consultez Listes de contrôle d’accès.

Si SeSecurityPrivilege n’est pas accordé ou activé lors de l’obtention d’un descripteur de sécurité, seul le dacl est retourné dans le descripteur de sécurité retourné. Pour plus d’informations, consultez Constantes de privilèges et exécution d’opérations privilégiées.

Vous pouvez mettre à jour la liste DACL et la liste de contrôle d’accès partagé dans l’instance de Win32_SecurityDescriptor lors de l’appel de cette méthode, mais vous pouvez également mettre à jour uniquement la liste DACL ou uniquement la liste de contrôle d’accès partagé.

Les valeurs suivantes dans SECURITY_DESCRIPTOR_CONTROL déterminer si la liste de contrôle d’accès partagé ou la liste de contrôle d’accès partagé ou les deux sont mises à jour.

• SE_DACL_PRESENT

  Indique que la liste dacl doit être mise à jour. S’il n’est pas défini, WMI conserve la valeur d’origine du DACL.

• SE_SACL_PRESENT

  Indique que la liste de contrôle d’accès partagé doit être mise à jour. S’il n’est pas défini, WMI conserve la valeur d’origine de la liste de contrôle d’accès partagé. Pour mettre à jour la liste de contrôle d’accès partagé, le compte doit avoir le privilège SeSecurityPrivilege activé. Pour le script, le nom du privilège est SeSecurityPrivilege. Pour plus d’informations, consultez Privilege Constants.

Si le fiduciaire du groupe et les propriétés du propriétaire ne sont pas NULL, ils sont mis à jour. Sinon, WMI conserve les valeurs d’origine. Pour plus d’informations, consultez Objets de descripteur de sécurité WMI.

Lorsqu’une nouvelle clé SACL a la valeur NULL dans un appel, la clé SACL du descripteur de sécurité sur l’objet sécurisable cible reste inchangée.

Spécifications

Besoin	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Namespace	Tous les espaces de noms WMI

Voir aussi

__SystemSecurity

Définition des descripteurs de sécurité de l’espace de noms