Méthode Delete de la classe Win32_Share

La méthode declasse Delete WMI supprime un nom de partage de la liste des ressources partagées d’un serveur, ce qui déconnecte les connexions à la 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 Delete();

Paramètres

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

Valeur retournée

Retourne l’une des valeurs répertoriées dans la liste suivante, ou toute autre valeur pour indiquer une erreur. Pour obtenir des codes d’erreur supplémentaires, consultez Constantes d’erreur WMI ou WbemErrorEnum. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

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 Delete est une méthode objet utilisée sur un instance d’une 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 correctement la méthode. L’opérateur Print peut supprimer uniquement les files d’attente d’imprimante. L’opérateur Communication peut supprimer uniquement les files d’attente des appareils de communication.

Exemples

L’exemple de code VBScript suivant supprime le partage spécifié.

On Error Resume Next

ComputerName = InputBox("Enter the computer name:", "Delete Share", "localhost")

SName = InputBox("Enter the name of the share:", "Delete Share")



Set Shares = GetObject("winmgmts:\\" & ComputerName & _
 "\root\cimv2").ExecQuery("SELECT * FROM Win32_Share WHERE name = '" & SName & "'")



For Each Share in Shares
 Share.Delete()
Next

L’exemple de code PowerShell suivant supprime les partages vides.

$Shares = Get-WMIObject Win32_Share | Where {$_.Name -eq ""}

Foreach ($Share in $Shares) {
   $Share.Delete()
}
"{0} blank shares found and removed" -f $shares.count

Spécifications

Voir aussi

Classes du système d’exploitation

Win32_Share