Méthode GetAccessMask de la classe Win32_Share

Article
06/12/2023

La méthode GetAccessMask retourne une image bitmap uint32 avec les droits d’accès au partage détenu par l’utilisateur ou le groupe au nom duquel le instance est retourné.

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 GetAccessMask();

Paramètres

Cette méthode n’a aucun paramètre.

Valeur retournée

Droits d’accès au partage détenu par l’utilisateur ou le groupe.

FILE_LIST_DIRECTORY

1 (0x1)

Accorde le droit de lire les données du fichier. Pour un répertoire, cette valeur accorde le droit de répertorier le contenu du répertoire.

FILE_ADD_FILE

2 (0x2)

Accorde le droit d’écrire des données dans le fichier. Pour un répertoire, cette valeur accorde le droit de créer un fichier dans le répertoire.

FILE_ADD_SUBDIRECTORY

4 (0x4)

Accorde le droit d’ajouter des données au fichier. Pour un répertoire, cette valeur accorde le droit de créer un sous-répertoire.

FILE_READ_EA

8 (0x8)

Accorde le droit de lire les attributs étendus.

FILE_WRITE_EA

16 (0x10)

Accorde le droit d’écrire des attributs étendus.

FILE_TRAVERSE

32 (0x20)

Accorde le droit d’exécuter un fichier. Pour un répertoire, le répertoire peut être parcouru.

FILE_DELETE_CHILD

64 (0x40)

Accorde le droit de supprimer un répertoire et tous les fichiers qu’il contient (ses enfants), même si les fichiers sont en lecture seule.

FILE_READ_ATTRIBUTES

128 (0x80)

Accorde le droit de lire les attributs de fichier.

FILE_WRITE_ATTRIBUTES

256 (0x100)

Accorde le droit de modifier les attributs de fichier.

DELETE

65536 (0x10000)

Octroie l’accès à la suppression.

READ_CONTROL

131072 (0x20000)

Octroie l’accès en lecture au descripteur de sécurité et au propriétaire.

WRITE_DAC

262144 (0x40000)

Octroie l’accès en écriture à la liste de contrôle d’accès discrétionnaire (DACL).

WRITE_OWNER

524288 (0x80000)

Affecte le propriétaire d’écriture.

SYNCHRONISER

1048576 (0x100000)

Synchronise l’accès et permet à un processus d’attendre qu’un objet entre dans l’état signalé.

Notes

La méthode GetAccessMask est une méthode objet qui est utilisée sur une occurrence de cette classe.

Exemples

L’exemple de code VBScript suivant crée un dossier de partage, puis obtient la valeur du masque d’accès dans le descripteur de sécurité qui sécurise le dossier de partage.

Const FILE_SHARE = 0
Const MAXIMUM_CONNECTIONS = 4000 
strComputer = "."

Set objWMIService = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set objNewShare = objWMIService.Get("Win32_Share")
Return = objNewShare.Create ("C:\Temp", "TestShare", FILE_SHARE, MAXIMUM_CONNECTIONS, "test share")

If Return <> 0 Then
          WScript.Echo Return
          WScript.Quit
End If

Set objShare = objWMIService.Get("Win32_Share.Name='TestShare'")
Return = objShare.GetAccessMask
WScript.Echo Return

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Win32_Share

Partager via