Método UserControlService da classe Win32_BaseService
O método de classe WMI tenta enviar um código de controle definido pelo usuário para um serviço.
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 UserControlService(
[in] uint8 ControlCode
);
Parâmetros
-
ControlCode [in]
-
Valor que especifica um comando de controle para um serviço. Por exemplo, um comando de controle é um comando "pause" ou "continue". O valor pode ser um código predefinido ou um valor e uma ação que o serviço define. Veja a seguir os códigos de controle predefinidos:
-
SERVICE_CONTROL_CONTINUE
-
Notifica um serviço em pausa a ser retomado.
-
SERVICE_CONTROL_INTERROGATE
-
Notifica um serviço para relatar as informações de status atuais para o gerenciador de controle de serviço.
-
SERVICE_CONTROL_NETBINDADD
-
Notifica um serviço de rede de que há um novo componente para associação.
-
SERVICE_CONTROL_NETBINDDISABLE
-
Notifica um serviço de rede de que uma de suas associações está desabilitada.
-
SERVICE_CONTROL_NETBINDENABLE
-
Notifica um serviço de rede de que uma associação desabilitada está habilitada.
-
SERVICE_CONTROL_NETBINDREMOVE
-
Notifica um serviço de rede de que um componente para associação foi removido.
-
SERVICE_CONTROL_PARAMCHANGE
-
Notifica um serviço de que seus parâmetros de inicialização foram alterados.
-
SERVICE_CONTROL_PAUSE
-
Notifica um serviço para pausar.
-
SERVICE_CONTROL_STOP
-
Notifica um serviço para parar.
Valor retornado
Retorna um dos valores listados na lista a seguir ou um valor diferente para indicar um erro.
-
Êxito
-
0
A solicitação é aceita.
-
Sem suporte
-
1
A solicitação não terá suporte.
-
Acesso negado
-
2
O usuário não tem os direitos de acesso necessários.
-
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 iniciou.
-
Tempo limite da solicitação de serviço
-
7
O serviço não responde à solicitação inicial rapidamente.
-
Falha desconhecida
-
8
Processo interativo.
-
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 da qual esse serviço depende é removida do sistema.
-
Falha na dependência do serviço
-
13
O serviço não encontra o serviço necessário de um serviço dependente.
-
Serviço Desabilitado
-
14
O serviço está 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
O serviço está sendo removido do sistema.
-
Serviço Sem Thread
-
17
Não há nenhum thread de execução para o serviço.
-
Dependência circular de status
-
18
Há dependências circulares quando o serviço é iniciado.
-
Nome duplicado de status
-
19
Há um serviço em execução com o mesmo nome.
-
Nome inválido de status
-
20
Há caracteres inválidos no nome do serviço.
-
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 em que esse serviço é executado não é vá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
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|