Método StopService da classe Win32_SystemDriver
O método de classe WMIStopService coloca o serviço representado pelo objeto Win32_SystemDriver no estado parado.
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 StopService();
Parâmetros
Esse método não tem parâmetros.
Valor retornado
Retornará um valor de 0 (zero) se o serviço tiver sido interrompido com êxito, 1 (um) se a solicitação não tiver suporte e qualquer outro número para indicar um erro.
-
0
-
A solicitação foi aceita.
-
1
-
A solicitação não terá suporte.
-
2
-
O usuário não tinha o acesso necessário.
-
3
-
O serviço não pode ser interrompido, porque outros serviços em execução dependem dele.
-
4
-
O código de controle pedido não é válido ou é inaceitável para o serviço.
-
5
-
O código de controle solicitado não pode ser enviado ao serviço porque o estado do serviço (Win32_BaseService. Propriedade State ) é igual a 0, 1 ou 2.
-
6
-
O serviço não foi iniciado.
-
7
-
O serviço não respondeu à solicitação de início em um tempo oportuno.
-
8
-
Uma falha desconhecida ocorreu na inicialização do serviço.
-
9
-
O caminho do diretório para o arquivo executável do serviço não foi encontrado.
-
10
-
O serviço já está em execução.
-
11
-
O banco de dados para adicionar um serviço novo está bloqueado.
-
12
-
Uma dependência da qual esse serviço depende foi removida do sistema.
-
13
-
O serviço não localizou o serviço necessário em um serviço dependente.
-
14
-
O serviço foi desabilitado do sistema.
-
15
-
O serviço não tem a autenticação correta para ser executado no sistema.
-
16
-
Esse serviço está sendo removido do sistema.
-
17
-
Não há nenhum thread de execução para o serviço.
-
18
-
Há dependências circulares quando o serviço é iniciado.
-
19
-
Há um serviço em execução com o mesmo nome.
-
20
-
Há caracteres inválidos no nome do serviço.
-
21
-
Parâmetros inválidos foram passados para o serviço.
-
22
-
A conta na qual esse serviço deve ser executado é inválida ou não tem as permissões para executar o serviço.
-
23
-
O serviço existe no banco de dados de serviços disponível no sistema.
-
24
-
O serviço está pausado atualmente no sistema.
Exemplos
O código do PowerShell a seguir interrompe o serviço "Classe de impressora USB da Microsoft".
$usbPrintDriver = Get-WmiObject -query "SELECT * FROM Win32_SystemDriver WHERE Name = 'usbprint'"
$Return = $usbPrintDriver.StopService()
"Stop Service Called. Return value is " + $return.ReturnValue + "."
"To figure out what this means, go look at the docs above this code snippet."
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| Cabeçalho |
|
| MOF |
|
| DLL |
|