ServiceController.ExecuteCommand(Int32) Método

Definición

Espacio de nombres:

System.ServiceProcess

Ensamblado:

System.ServiceProcess.ServiceController.dll

Ensamblado:

System.ServiceProcess.dll

Ejecuta un comando personalizado en el servicio.

public:
 void ExecuteCommand(int command);

public void ExecuteCommand (int command);

member this.ExecuteCommand : int -> unit

Public Sub ExecuteCommand (command As Integer)

Parámetros

command

Int32

Marca de comandos definida por la aplicación que indica qué comando personalizado se va a ejecutar. El valor debe estar comprendido entre 128 y 256, ambos inclusive.

Excepciones

Win32Exception

Error de acceso a la API del sistema.

InvalidOperationException

No se encontró el servicio.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del ServiceController.ExecuteCommand(Int32) método para ejecutar comandos personalizados en el ejemplo de SimpleService servicio.

using System;
using System.ServiceProcess;

namespace test_exec_cmnd
{
    class Program
    {
        private enum SimpleServiceCustomCommands { StopWorker = 128, RestartWorker, CheckWorker };
        static void Main(string[] args)
        {
            ServiceController myService = new ServiceController("SimpleService");
            myService.ExecuteCommand((int)SimpleServiceCustomCommands.StopWorker);
            myService.ExecuteCommand((int)SimpleServiceCustomCommands.RestartWorker);
            myService.ExecuteCommand((int)SimpleServiceCustomCommands.CheckWorker);
        }
    }
}

Imports System.ServiceProcess



Class Program
    
    Private Enum SimpleServiceCustomCommands
        StopWorker = 128
        RestartWorker
        CheckWorker '
    End Enum 'SimpleServiceCustomCommands

    Shared Sub Main(ByVal args() As String) 
        Dim myService As New ServiceController("SimpleService")
        myService.ExecuteCommand(Fix(SimpleServiceCustomCommands.StopWorker))
        myService.ExecuteCommand(Fix(SimpleServiceCustomCommands.RestartWorker))
        myService.ExecuteCommand(Fix(SimpleServiceCustomCommands.CheckWorker))
    
    End Sub
End Class

Comentarios

Cuando se llama a ExecuteCommand, el estado del servicio no cambia. Si se inició el servicio, el estado sigue siendo Running. Si el servicio se detuvo, el estado sigue siendo Stopped, etc. Para procesar el comando personalizado, el servicio debe invalidar el OnCustomCommand método y proporcionar un controlador para el comando identificado por el command parámetro .

Consulte también

• OnCustomCommand(Int32)