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
CIMWin32. mof
DLL
CIMWin32.dll

Voir aussi

Classes du système d’exploitation

_Partage Win32