Delete-Methode der Win32_Share-Klasse

Die DeleteWMI-Klassenmethode löscht einen Freigabenamen aus der Liste der freigegebenen Ressourcen eines Servers und trennt verbindungen mit der freigegebenen Ressource.

In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.

Syntax

uint32 Delete();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Erfolg (0)

Zugriff verweigert (2)

Unbekannter Fehler (8)

Ungültiger Name (9)

Ungültige Ebene (10)

Ungültiger Parameter (21)

Doppelte Freigabe (22)

Umgeleiteter Pfad (23)

Unbekanntes Gerät oder Verzeichnis (24)

Netzname nicht gefunden (25)

Sonstige (26 4294967295)

Bemerkungen

Die Delete-Methode ist eine Objektmethode und wird für eine instance einer Klasse verwendet.

Nur Mitglieder der lokalen Gruppe Administratoren oder Kontooperatoren oder mitglieder mit Kommunikations-, Druck- oder Serveroperatorgruppen können die Methode erfolgreich ausführen. Der Druckeroperator kann nur Druckerwarteschlangen löschen. Der Kommunikationsoperator kann nur Kommunikationsgerätewarteschlangen löschen.

Beispiele

Im folgenden VBScript-Codebeispiel wird die angegebene Freigabe gelöscht.

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

Im folgenden PowerShell-Codebeispiel werden leere Freigaben gelöscht.

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

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

Anforderungen

Siehe auch

Betriebssystemklassen

Win32_Share