ServiceController.Start ServiceController.Start ServiceController.Start ServiceController.Start Method

Definition

Starts the service.

Overloads

Start() Start() Start() Start()

Starts the service, passing no arguments.

Start(String[]) Start(String[]) Start(String[]) Start(String[])

Starts a service, passing the specified arguments.

Start() Start() Start() Start()

Starts the service, passing no arguments.

public:
 void Start();
public void Start ();
member this.Start : unit -> unit
Public Sub Start ()
Exceptions

An error occurred when accessing a system API.

Examples

The following example uses the ServiceController class to check whether the Alerter service is stopped. If the service is stopped, the example starts the service and waits until the service status is set to Running.

// Check whether the Alerter service is started.
ServiceController^ sc = gcnew ServiceController;
if ( sc )
{
   sc->ServiceName =  "Alerter";
   Console::WriteLine(  "The Alerter service status is currently set to {0}", sc->Status );
   if ( sc->Status == (ServiceControllerStatus::Stopped) )
   {
      // Start the service if the current status is stopped.
      Console::WriteLine(  "Starting the Alerter service..." );
      try
      {
         // Start the service, and wait until its status is "Running".
         sc->Start();
         sc->WaitForStatus( ServiceControllerStatus::Running );
         
         // Display the current service status.
         Console::WriteLine(  "The Alerter service status is now set to {0}.", sc->Status );
      }
      catch ( InvalidOperationException^ e ) 
      {
         Console::WriteLine(  "Could not start the Alerter service." );
      }
   }
}

// Check whether the Alerter service is started.

ServiceController sc  = new ServiceController();
sc.ServiceName = "Alerter";
Console.WriteLine("The Alerter service status is currently set to {0}", 
                   sc.Status.ToString());

if (sc.Status == ServiceControllerStatus.Stopped)
{
   // Start the service if the current status is stopped.

   Console.WriteLine("Starting the Alerter service...");
   try 
   {
      // Start the service, and wait until its status is "Running".
      sc.Start();
      sc.WaitForStatus(ServiceControllerStatus.Running);
   
      // Display the current service status.
      Console.WriteLine("The Alerter service status is now set to {0}.", 
                         sc.Status.ToString());
   }
   catch (InvalidOperationException)
   {
      Console.WriteLine("Could not start the Alerter service.");
   }
}

' Check whether the Alerter service is started.

Dim sc As New ServiceController()
sc.ServiceName = "Alerter"
Console.WriteLine("The Alerter service status is currently set to {0}", sc.Status)

If sc.Status = ServiceControllerStatus.Stopped Then
   ' Start the service if the current status is stopped.
   Console.WriteLine("Starting the Alerter service...")

   Try
      ' Start the service, and wait until its status is "Running".
      sc.Start()
      sc.WaitForStatus(ServiceControllerStatus.Running)
      
      ' Display the current service status.
      Console.WriteLine("The Alerter service status is now set to {0}.", sc.Status)
   Catch 
      Console.WriteLine("Could not start the Alerter service.")
   End Try
End If

Remarks

You cannot call Stop for the service until the service controller status is Running.

Security

ServiceControllerPermission
for controlling services on the computer. Associated enumeration: Control

SecurityPermission
for unrestricted access to service information. Associated enumeration: Unrestricted

See Also

Start(String[]) Start(String[]) Start(String[]) Start(String[])

Starts a service, passing the specified arguments.

public:
 void Start(cli::array <System::String ^> ^ args);
public void Start (string[] args);
member this.Start : string[] -> unit
Public Sub Start (args As String())
Parameters
args
String[]

An array of arguments to pass to the service when it starts.

Exceptions

An error occurred when accessing a system API.

Remarks

You cannot call Stop for the service until the service controller status is Running.

Security

ServiceControllerPermission
for controlling services on the computer. Associated enumeration: Control

SecurityPermission
for unrestricted access to service information. Associated enumeration: Unrestricted

See Also

Applies to