Méthode ChangeSecurityPermissions de la classe Win32_ShortcutFile

La méthode de classe WMIChangeSecurityPermissions modifie les autorisations de sécurité pour le fichier de raccourci logique spécifié dans le chemin d’accès de l’objet. Si le fichier logique est un répertoire, ChangeSecurityPermissions est récursif et modifie les autorisations de sécurité de tous les fichiers et sous-répertoires contenus dans le répertoire. ChangeSecurityPermissions retourne une valeur entière de 0 (zéro) si les autorisations sont modifiées et un nombre différent pour indiquer une erreur.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 ChangeSecurityPermissions(
  [in] Win32_SecurityDescriptor SecurityDescriptor,
  [in] uint32                   Option
);

Paramètres

SecurityDescriptor [in]

Expression qui se résout en une instance de Win32_SecurityDescriptor. Ce descripteur contient de nouvelles autorisations de sécurité pour le instance de Win32_PageFile.

Option [in]

Privilège de sécurité réel à modifier. Par exemple, pour modifier le propriétaire et la sécurité DACL, utilisez :

Option = 1 + 4

ou

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1)

Modifiez le propriétaire du fichier logique.

CHANGE_GROUP_SECURITY_INFORMATION (2)

Modifiez le groupe du fichier logique.

CHANGE_DACL_SECURITY_INFORMATION (4)

Modifiez la liste de contrôle d’accès discrétionnaire (DACL) du fichier logique.

CHANGE_SACL_SECURITY_INFORMATION (8)

Modifiez la liste de contrôle d’accès système (SACL) du fichier logique.

Valeur retournée

Retourne une valeur de 0 (zéro) si les autorisations sont modifiées et un nombre différent pour indiquer une erreur.

Success

0

La demande a réussi.

accès refusé

2

L’accès est refusé.

Échec non spécifié

8

Un échec non spécifié s’est produit.

Objet non valide

9

Le nom spécifié n’est pas valide.

L’objet existe déjà

10

L'objet spécifié existe déjà.

Système de fichiers et non NTFS

11

Le système de fichiers n’est pas un système de fichiers NTFS.

Plateforme non NT/Windows 2000

12

La plateforme n’est pas Windows.

Le lecteur n’est pas le même

13

Le lecteur n’est pas le même.

Répertoire non vide

14

Le répertoire n'est pas vide.

Violation de partage

15

Il y a une violation de partage.

Fichier de démarrage non valide

16

Le fichier de début spécifié n’est pas valide.

Privilège non détenu

17

Aucun privilège requis pour l’opération n’est conservé.

Paramètre non valide

21

Un paramètre spécifié n’est pas valide.

Spécifications

Voir aussi

Classes du système d’exploitation

Win32_ShortcutFile