Método Delete da classe Win32_Share
O método de classe DeleteWMI exclui um nome de compartilhamento da lista de recursos compartilhados de um servidor, desconectando conexões com o recurso compartilhado.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 Delete();
Parâmetros
Esse método não tem parâmetros.
Valor retornado
Retorna um dos valores listados na lista a seguir ou qualquer outro valor para indicar um erro. Para obter códigos de erro adicionais, consulte Constantes de erro WMI ou WbemErrorEnum. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.
-
Êxito (0)
-
Acesso negado (2)
-
Falha desconhecida (8)
-
Nome inválido (9)
-
Nível inválido (10)
-
Parâmetro inválido (21)
-
Compartilhamento duplicado (22)
-
Caminho redirecionado (23)
-
Dispositivo ou diretório desconhecido (24)
-
Nome líquido não encontrado (25)
-
Outro (26 4294967295)
Comentários
O método Delete é um método de objeto e é usado em uma instância de uma classe .
Somente os membros do grupo local Administradores ou Operadores de Conta ou aqueles com associação de grupo de operadores de Comunicação, Impressão ou Servidor podem executar o método com êxito. O operador Print pode excluir apenas filas de impressora. O operador comunicação pode excluir apenas filas de dispositivo de comunicação.
Exemplos
O exemplo de código VBScript a seguir exclui o compartilhamento especificado.
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
O exemplo de código do PowerShell a seguir exclui compartilhamentos em branco.
$Shares = Get-WMIObject Win32_Share | Where {$_.Name -eq ""}
Foreach ($Share in $Shares) {
$Share.Delete()
}
"{0} blank shares found and removed" -f $shares.count
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|