Метод Delete класса Win32_Share

Статья
06/12/2023

Метод класса DeleteWMI удаляет имя общей папки из списка общих ресурсов сервера, отключая подключения к общему ресурсу.

В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.

Синтаксис

uint32 Delete();

Параметры

Этот метод не имеет параметров.

Возвращаемое значение

Возвращает одно из значений, перечисленных в следующем списке, или любое другое значение, указывающее на ошибку. Дополнительные коды ошибок см. в разделе WMI Error Constants или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешное выполнение (0)
Доступ запрещен (2)
Неизвестный сбой (8)
Недопустимое имя (9)
Недопустимый уровень (10)
Недопустимый параметр (21)
Дублировать общий ресурс (22)
Перенаправленный путь (23)
Неизвестное устройство или каталог (24)
Net name not found (25)
Другое (26 4294967295)

Только члены локальной группы "Администраторы" или "Операторы учетных записей" или члены группы операторов "Связь", "Печать" или "Сервер" могут успешно выполнять метод . Оператор Print может удалять только очереди принтера. Оператор связи может удалять только очереди устройств связи.

Примеры

Следующий пример кода VBScript удаляет указанную общую папку.

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

В следующем примере кода PowerShell удаляются пустые общие папки.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

См. также раздел

Классы операционной системы
Win32_Share

Поделиться через