Méthode SetShareInfo de la _ classe de partage Win32
La méthode de classe WMI SetShareInfo définit les paramètres d’une ressource partagée.
Cette rubrique utilise la syntaxe format MOF (MOF). 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 [ dans, facultatif]
-
Limite du nombre maximal d’utilisateurs autorisés à utiliser cette ressource simultanément.
Exemple : 10. Ce paramètre est facultatif.
-
Description [ dans, facultatif]
-
Commentaire facultatif pour décrire la ressource partagée.
-
Accès [ dans, facultatif]
-
Descripteur de sécurité pour les autorisations au niveau de l’utilisateur. Un descripteur de sécurité contient des informations sur l’autorisation, le propriétaire et les capacités d’accès de la ressource. Pour plus d’informations, consultez _ SecurityDescriptor Win32.
Valeur de retour
Retourne l’une des valeurs répertoriées dans la liste suivante ou toute autre valeur pour indiquer une erreur.
-
Opération réussie (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 d’accès Redirigé (23)
-
Périphérique ou répertoire inconnu (24)
-
Nom de réseau introuvable (25)
-
Autre (26 4294967295)
Notes
La méthode SetShareInfo est une méthode d’objet dynamique qui est utilisée sur une occurrence de cette classe.
Seuls les membres du groupe local Administrateurs ou opérateurs de compte ou ceux ayant une appartenance de groupe communication, impression ou opérateur de serveur peuvent exécuter SetShareInfo. L’opérateur Print peut uniquement définir des files d’attente d’impression. L’opérateur de communication ne peut définir que 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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
\Cimv2 racine |
| MOF |
|
| DLL |
|