ServiceBase.OnCustomCommand(Int32) ServiceBase.OnCustomCommand(Int32) ServiceBase.OnCustomCommand(Int32) ServiceBase.OnCustomCommand(Int32) Method

Definição

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.When implemented in a derived class, OnCustomCommand(Int32) executes when the Service Control Manager (SCM) passes a custom command to the service. Especifica as ações a serem aditadas quando ocorrer um comando com o valor do parâmetro especificado.Specifies actions to take when a command with the specified parameter value occurs.

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 Int32 Int32 Int32

A mensagem de comando enviada ao serviço.The command message sent to the service.

Comentários

OnCustomCommand permite que você especifique uma funcionalidade adicional além de iniciar, parar, pausar e continuando serviços.OnCustomCommand lets you specify additional functionality beyond starting, stopping, pausing and continuing services.

O SCM não examina o comando personalizado para verificar se o serviço oferece suporte a command parâmetro passado.The SCM does not examine the custom command to verify whether the service supports the command parameter passed in. Ele passa o comando personalizado diretamente para o serviço.It passes the custom command directly to the service. Se o serviço não reconhecer o command parâmetro, ela não faz nada.If the service does not recognize the command parameter, it does nothing.

Comandos personalizados são gerados por um ExecuteCommand instrução em um ServiceController componente.Custom commands are raised by an ExecuteCommand statement in a ServiceController component. Usar uma instrução switch ou if... em seguida, condição para lidar com os comandos personalizados que você define no seu serviço.Use a switch statement or if..then condition to handle the custom commands you define on your service.

Os únicos valores para um comando personalizado que você pode definir em seu aplicativo ou usar em OnCustomCommand são aqueles entre 128 e 255.The only values for a custom command that you can define in your application or use in OnCustomCommand are those between 128 and 255. Inteiros abaixo 128 correspondem aos valores de reservadas pelo sistema.Integers below 128 correspond to system-reserved values.

Se o AutoLog é de propriedade true, comandos personalizados, como todos os outros comandos, gravam entradas de log de eventos para relatar se a execução do método teve êxito ou falha.If the AutoLog property is true, custom commands, like all other commands, write entries to the event log to report whether the method execution succeeded or failed.

Aplica-se a

Veja também