Método UserControlService da classe Win32_BaseService

Artigo
06/12/2023

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

A solicitação é aceita.

Sem suporte

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

Acesso negado

O usuário não tem os direitos de acesso necessários.

Serviços dependentes em execução

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

Controle de Serviço Inválido

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

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

O serviço não iniciou.

Tempo limite da solicitação de serviço

O serviço não responde à solicitação inicial rapidamente.

Falha desconhecida

Processo interativo.

Caminho não encontrado

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

Serviço já em execução

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

Banco de Dados de Serviço Bloqueado

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

Dependência de serviço excluída

Uma dependência da qual esse serviço depende é removida do sistema.

Falha na dependência do serviço

O serviço não encontra o serviço necessário de um serviço dependente.

Serviço Desabilitado

O serviço está desabilitado do sistema.

Falha no logon do serviço

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

Serviço marcado para exclusão

O serviço está sendo removido do sistema.

Serviço Sem Thread

Não há nenhum thread de execução para o serviço.

Dependência circular de status

Há dependências circulares quando o serviço é iniciado.

Nome duplicado de status

Há um serviço em execução com o mesmo nome.

Nome inválido de status

Há caracteres inválidos no nome do serviço.

Parâmetro status inválido

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

Conta de serviço inválida de status

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

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

Serviço já pausado

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

Confira também

Classes do sistema operacional
Win32_BaseService