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	Sdoias.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_SystemDriver