ServiceBase.OnCustomCommand(Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Quando implementado em uma classe derivada, OnCustomCommand(Int32) é executado quando o SCM (Service Control Manager) passa um comando personalizado para o serviço. Especifica ações a serem executadas 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 -> unitProtected 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, condicione a manipulação dos 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 OnCustomCommand são 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, escreva entradas no log de eventos para relatar se a execução do método foi bem-sucedida ou falhou.
