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

Artigo
06/12/2023

O método de classe WMIUserControlService tenta enviar um código de controle definido pelo usuário para o serviço referenciado.

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]: Especifica valores definidos (de 128 a 255) que fornecem comandos de controle específicos a um usuário.

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.

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: Falha desconhecida ao iniciar o 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 em que 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: O serviço não tem thread de execução.
18: O serviço tem dependências circulares quando é iniciado.
19: Um serviço está em execução com o mesmo nome.
20: O nome do serviço tem caracteres inválidos.
21: Parâmetros inválidos foram passados para o serviço.
22: A conta sob a qual esse serviço é 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.

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

Compartilhar via