ServiceBase.OnCustomCommand(Int32) Método

Definição

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.ServiceController.dll

Pacote:

System.ServiceProcess.ServiceController v9.0.0-preview.3.24172.9

Origem:

ServiceBase.cs

Quando implementado em uma classe derivada, OnCustomCommand(Int32) é executado quando o SCM (Gerenciador de Controle de Serviço) passa um comando personalizado para o serviço. Especifica as ações a serem aditadas quando ocorrer um comando com o valor do parâmetro especificado.

protected:
 virtual void OnCustomCommand(int command);

protected virtual void OnCustomCommand (int command);

abstract member OnCustomCommand : int -> unit
override this.OnCustomCommand : int -> unit

Protected Overridable Sub OnCustomCommand (command As Integer)

Parâmetros

command

Int32

A mensagem de comando enviada ao serviço.

Comentários

OnCustomCommand permite que você especifique funcionalidades adicionais além de iniciar, parar, pausar e continuar serviços.

O SCM não examina o comando personalizado para verificar se o serviço dá suporte ao command parâmetro passado. Ele passa o comando personalizado diretamente para o serviço. Se o serviço não reconhecer o command parâmetro, ele não fará nada.

Os comandos personalizados são gerados por uma instrução ExecuteCommand em um ServiceController componente. Use uma instrução switch ou if.. em seguida, condição para lidar com os comandos personalizados que você define em seu serviço.

Os únicos valores para um comando personalizado que você pode definir em seu aplicativo ou usar são OnCustomCommand aqueles entre 128 e 255. Inteiros abaixo de 128 correspondem a valores reservados pelo sistema.

Se a AutoLog propriedade for true, comandos personalizados, como todos os outros comandos, gravarão entradas no log de eventos para relatar se a execução do método foi bem-sucedida ou falhou.

Confira também

• OnContinue()
• OnPause()
• OnPowerEvent(PowerBroadcastStatus)
• OnShutdown()
• OnStart(String[])
• OnStop()