Método ChangeStartMode da classe Win32_Service (Provedores WMI CIMWin32)

O método de classe WMIChangeStartMode modifica o modo inicial de um Win32_Service.

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 ChangeStartMode(
  [in] string StartMode = Auto Start
);

Parâmetros

StartMode [in]

Modo inicial do serviço base do Windows.

Inicialização inicial ("Inicialização")

Driver de dispositivo iniciado pelo carregador do sistema operacional. Esse valor só é válido para serviços do driver.

Sistema ("Sistema")

Driver de dispositivo iniciado pelo processo de inicialização do sistema operacional. Esse valor só é válido para serviços do driver.

Início Automático ("Automático")

Serviço a ser iniciado automaticamente pelo gerenciador de controle de serviço durante a inicialização do sistema.

Início da Demanda ("Manual")

Serviço a ser iniciado pelo gerenciador de controle de serviço quando um processo chama o método StartService .

Desabilitado ("Desabilitado")

Serviço que não pode mais ser iniciado.

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

A solicitação foi aceita.

Sem suporte

1

A solicitação não terá suporte.

Acesso negado

2

O usuário não tinha o acesso necessário.

Serviços dependentes em execução

3

O serviço não pode ser interrompido, porque outros serviços em execução dependem dele.

Controle de Serviço Inválido

4

O código de controle pedido não é válido ou é inaceitável para o serviço.

O serviço não pode aceitar o controle

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.

Serviço Não Ativo

6

O serviço não foi iniciado.

Tempo limite da solicitação de serviço

7

O serviço não respondeu à solicitação de início em um tempo oportuno.

Falha desconhecida

8

Falha desconhecida ao iniciar o serviço.

Caminho não encontrado

9

O caminho do diretório para o arquivo executável do serviço não foi encontrado.

Serviço já em execução

10

O serviço já está em execução.

Banco de Dados de Serviço Bloqueado

11

O banco de dados para adicionar um serviço novo está bloqueado.

Dependência de serviço excluída

12

Uma dependência em que esse serviço depende foi removida do sistema.

Falha na dependência do serviço

13

O serviço não localizou o serviço necessário em um serviço dependente.

Serviço Desabilitado

14

O serviço foi desabilitado do sistema.

Falha no logon do serviço

15

O serviço não tem a autenticação correta para ser executado no sistema.

Serviço marcado para exclusão

16

Esse serviço está sendo removido do sistema.

Serviço Sem Thread

17

O serviço não tem thread de execução.

Dependência circular de status

18

O serviço tem dependências circulares quando é iniciado.

Nome duplicado de status

19

Um serviço está em execução com o mesmo nome.

Nome inválido de status

20

O nome do serviço tem caracteres inválidos.

Parâmetro status inválido

21

Parâmetros inválidos foram passados para o serviço.

Conta de serviço inválida de status

22

A conta sob a qual esse serviço é executado é inválida ou não tem as permissões para executar o serviço.

O Serviço de Status existe

23

O serviço existe no banco de dados de serviços disponível no sistema.

Serviço já pausado

24

O serviço está pausado atualmente no sistema.

Outros

25 4294967295

Exemplos

O seguinte exemplo alterar o StartMode de um PowerShell de serviço , extraído da Galeria do TechNet, altera o modo de início de um serviço.

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_Service

Tarefas do WMI: Serviços