ServiceController In C#

A ServiceController component allows us to access and manage Windows Services running on a machine. In this article, I will discuss how to use a ServiceController class to load all services and get information about them in a Windows Forms application using Visual Studio 2010.

Adding System.ServiceProcess Reference

A ServiceController represents a Windows Service and is defined in the System.ServiceProcess namespace. Before this namespace can be imported, you must add reference to the System.ServiceProcess assembly.

To add reference to an assembly, right click on the project name in Visual Studio and select Add Reference menu item and then browse the assembly you need to add to your application.

Adding System.ServiceProcess Reference

Getting all services installed on a machine

ServiceController.GetServices static method returns a list of all services running on a machine. The following code snippet gets all the services and displays them in a ListBox.  

  1. foreach (ServiceController service inServiceController.GetServices())    
  2. {    
  3.    ServicesListBox.Items.Add(service.DisplayName);    
  4. }  

ServiceController Properties

Here is a list of ServiceController class properties.

  • CanPauseAndContinue - Service can be paused and continued.
  • CanShutdown - Service can be shut down.
  • CanStop - Service can be stopped.
  • DisplayName - Friendly name of a service.
  • MachineName - Name of the computer where this service is installed.
  • ServiceName - Service name.
  • ServiceHandle - Service handle or Id.
  • ServiceType - Type of a service such as device driver, process, or kernel.
  • Status - Status of a service such as running, stopped, or paused.

The following code snippet uses some of these properties.

  1. privatevoid GetAllServices()  
  2. {  
  3.     foreach(ServiceController service inServiceController.GetServices())   
  4.     {  
  5.         string serviceName = service.ServiceName;  
  6.         string serviceDisplayName = service.DisplayName;  
  7.         string serviceType = service.ServiceType.ToString();  
  8.         string status = service.Status.ToString();  
  9.         ServicesListBox.Items.Add(serviceName + "" + serviceDisplayName + serviceType + " " + status);  
  10.     }  
  11. }  

Getting all Device Driver Services installed on a machine

ServiceController.GetDevices static method returns a list of all device driver services running on a machine. The following code snippet gets all the device driver services and displays them in a ListBox.

  1. privatevoid GetAllDevices() {  
  2.     foreach(ServiceController device inServiceController.GetDevices()) {  
  3.         string name = device.ServiceName;  
  4.         string displayName = device.DisplayName;  
  5.         string type = device.ServiceType.ToString();  
  6.         string status = device.Status.ToString();  
  7.         ServicesListBox.Items.Add(name + "" + displayName + type + " " + status);  
  8.     }  
  9. }  

Start, Stop, Pause, Continue, Refresh and Close a Service

We can start, stop, pause, continue and refresh a service using Start, Stop, Pause, Continue, and Refresh methods. Close method disconnects this ServiceController instance from the service and frees all the resources that the instance allocated.

The following code snippet checks if a service is stopped, starts it; otherwise stops it.

  1. ServiceController service = newServiceController("MyServiceName");  
  2. if ((service.Status.Equals(ServiceControllerStatus.Stopped)) || (service.Status.Equals(ServiceControllerStatus.StopPending))) service.Start();  
  3. else service.Stop();  

Summary

In this article, we discussed how to use a ServiceController to get access to services available on a machine.