ServiceBase.OnCustomCommand(Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitProtected 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.