Méthode SetShareInfo de la classe Win32_Share

La méthode de classe WMISetShareInfo définit les paramètres d’une ressource partagée.

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 SetShareInfo(
  [in, optional] uint32                   MaximumAllowed,
  [in, optional] string                   Description,
  [in, optional] Win32_SecurityDescriptor Access
);

Paramètres

MaximumAllowed [in, facultatif]

Limite du nombre maximal d’utilisateurs autorisés à utiliser cette ressource simultanément.

Exemple : 10. Ce paramètre est facultatif.

Description [in, facultatif]

Commentaire facultatif pour décrire la ressource partagée.

Access [in, facultatif]

Descripteur de sécurité pour les autorisations au niveau de l’utilisateur. Un descripteur de sécurité contient des informations sur les fonctionnalités d’autorisation, de propriétaire et d’accès de la ressource. Pour plus d’informations, consultez Win32_SecurityDescriptor.

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante ou toute autre valeur pour indiquer une erreur.

Réussite (0)

Accès refusé (2)

Échec inconnu (8)

Nom non valide (9)

Niveau non valide (10)

Paramètre non valide (21)

Partage en double (22)

Chemin redirigé (23)

Appareil ou répertoire inconnu (24)

Nom du réseau introuvable (25)

Autres (26 4294967295)

Notes

La méthode SetShareInfo est une méthode d’objet dynamique utilisée sur une occurrence de cette classe.

Seuls les membres du groupe local Administrateurs ou Opérateurs de compte ou ceux qui sont membres du groupe d’opérateurs Communication, Impression ou Serveur peuvent exécuter SetShareInfo. L’opérateur d’impression peut uniquement définir des files d’attente d’imprimante. L’opérateur Communication peut uniquement définir des files d’attente d’appareils de communication.

Exemples

L’exemple PowerShell suivant met à jour le nom du partage newShare .

$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)

Spécifications

Voir aussi

Classes du système d’exploitation

Win32_Share