Compartir a través de


ServiceBase.OnCustomCommand(Int32) Método

Definición

Si se implementa en una clase derivada, OnCustomCommand(Int32) se ejecuta cuando el Administrador de control de servicios (SCM, Service Control Manager) pasa un comando personalizado al servicio. Especifica las acciones que deben realizarse cuando se ejecuta un comando con el valor de 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

Mensaje de comando enviado al servicio.

Comentarios

OnCustomCommand le permite especificar funcionalidad adicional más allá de iniciar, detener, pausar y continuar servicios.

El SCM no examina el comando personalizado para comprobar si el servicio admite el command parámetro pasado. Pasa el comando personalizado directamente al servicio. Si el servicio no reconoce el command parámetro , no hace nada.

Los comandos personalizados se generan mediante una ExecuteCommand instrucción en un ServiceController componente. Use una instrucción switch o if.. a continuación, condición para controlar los comandos personalizados que defina en el servicio.

Los únicos valores de un comando personalizado que puede definir en la aplicación o usar en OnCustomCommand son los comprendidos entre 128 y 255. Los enteros inferiores a 128 corresponden a valores reservados por el sistema.

Si la AutoLog propiedad es true, los comandos personalizados, como todos los demás comandos, escriben entradas en el registro de eventos para notificar si la ejecución del método se realizó correctamente o no.

Se aplica a

Consulte también