ServiceBase.OnCustomCommand(Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Quando implementado numa classe derivada, OnCustomCommand(Int32) executa-se quando o Service Control Manager (SCM) passa um comando personalizado ao serviço. Especifica ações a tomar quando ocorre 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.
Observações
OnCustomCommand Permite-lhe especificar funcionalidades adicionais para além de iniciar, parar, pausar e continuar serviços.
O SCM não examina o comando personalizado para verificar se o serviço suporta o command parâmetro passado. Passa o comando personalizado diretamente para o serviço. Se o serviço não reconhecer o command parâmetro, não faz nada.
Comandos personalizados são gerados por uma ExecuteCommand instrução num ServiceController componente. Use uma instrução switch ou se... Depois, condiciona para gerir os comandos personalizados que defines no teu serviço.
Os únicos valores para um comando personalizado que pode definir na sua aplicação ou usar OnCustomCommand são os 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, escrevem entradas no registo de eventos para reportar se a execução do método foi bem-sucedida ou falhou.