Click here to Skip to main content
11,495,743 members (64,961 online)
Click here to Skip to main content

Windows Services information component

, 25 Sep 2002 74.2K 1.6K 27
Rate this:
Please Sign up or sign in to vote.
An article on a Windows Services component

Introduction

This article is on a reusable windows service information component, which queries & retrieves the window’s service information. Service executables don’t have user interface and they run in the background for long periods. These services can be automatically started when the computer boots, can be paused and restarted. There are two kinds of services, which runs in windows. They are Device Driver services and Non Device Driver services. Apart from that the service can be a interactive service or non-interactive service. An interactive service is a service that can interact with the desktop.

In .NET framework library the System.ServiceProcess namespace provides classes that allow you to implement, install, and control Windows service applications. To implement a service we need to inherit from ServiceBase class. In this article we are not going to implement a service; but we are going to develop a component which will retrieve & query the existing services. In order to proceed with this we will use ServiceController class (alias System.ServiceProcess.ServiceController). The ServiceController class enables you to connect to an existing service and manipulate it or get information about it.

Details

So our component helps in administering the services running in the local system. The ServiceBase class defines the processing, a service performs when a command occurs. The ServiceController is the agent that enable us to call those commands on the services. So we are going to create a component which is derived from System.ComponentModel.Component, the default implementation of IComponent. IComponent serves as the base class for all components in the common language runtime and IComponent allows a component to keep track of design-time information, such as its container component or its name, or to access services that the designer may expose.

Component class is remotable and derives from MarshalByRefObject which enables access to objects across application domain boundaries in applications that support remoting. Lets discuss first about ServiceInfo component. ServiceInfo Class is derived from Component class of .NET framework and this component will have read/write properties for getting/setting the Service information. So I have selected important methods of ServiceController class methods to query the services.

Namespace : ServiceInfoLib

Class: ServiceInfo

Properties :

  1. DisplayType (get/set property)

Methods:

  1. GetNonDDServicesDetails() (gets the Non Device Driver Service Details)
  2. GetDDServicesDetails() (gets the Device Driver Service Details)
  3. GetNonDDServicesStatus() (gets the Non Device Driver Service Status)
  4. GetDDServicesStatus() (gets the Device Driver Service Status)
  5. FindService(string s) (Checks whether service exists or not)

Most of the methods in ServiceInfo component returns a string array. Internally all the methods of the component will call the ServiceController methods.

Brief Description about the component methods

  • The GetNonDDServiceDetails() method of ServiceInfo component returns a list of all the Non Device Driver Services installed on your local system. It internally calls the SystemController.GetServices() method. It also uses the property called DisplayType in ServerInfo component where the property get/set the display name of the service. If it is set to display type ‘D’ then it gives the list of friendly display Name of the Services and if its set to ‘S’ then it gives the list of Service Name of the Services; internally it calls the ServiceController DisplayName and ServiceName properties.
  • The GetDDServiceDetails() method of ServiceInfo component returns a list of all the Device Driver Service installed on your local system. It internally calls the SystemController.GetDevices() method.
  • The GetNonDDServiceStatus() method of ServiceInfo component returns a list of all the Non Device Driver Service installed on your local system and their status, which indicates whether the service is running, stopped, or paused, or whether a start, stop, pause, or continue command is pending. It internally calls the SystemController.GetServices() method and ServiceController.Status property which returns the ServiceControllerStatus class which indicates the status. In the component, I used ResolveSrvStatus method to resolve the exact status.
  • The GetDDServiceStatus() method of ServiceInfo component returns a list of all the Device Driver Services installed on your local system and their  status which indicates whether the service is running, stopped, or paused, or whether a start, stop, pause, or continue command is pending. It internally calls the SystemController.GetDevices() method and ServiceController.Status property which returns the ServiceControllerStatus class which indicates the status. In the component I used ResolveSrvStatus method to resolve the exact status.
  • The FindService(string s) method of ServiceInfo component is to check whether a particular service exists in the local machine or not; if its found it returns a string saying ‘Found’ and if that particular service does not exist, then it returns ‘Not Found’

Source Code

// SrvInfoLib.cs 
// ServiceInfo component code in c# 
using System; 
using System.ComponentModel; 
using System.ServiceProcess ; 
namespace ServiceInfoLib 
{ 
    /// <summary> 
    /// ServiceInfo Class gets the windows service details. 
    /// </summary> 
public class ServiceInfo: Component 
{ 

    private static char cDTyp='D'; // 'D' -> Display Name 
    // 'S' -> Service Name 

    public char DisplayType 
    { 
        set 
        { 
            cDTyp=value; 
        } 
        get 
        { 
            return cDTyp; 
        } 
    } 
    public ServiceInfo(){} 
    //Retrieves a list of Non Device Driver Services 
    public  string[] GetNonDDServicesDetails() 
    { 

        string[] s=null; 
        try 
        { 

            ServiceController[] srvC=
                ServiceController.GetServices(); 
            s=new string[srvC.Length]; 

            for(int i=0; i < srvC.Length; i++) 
            { 
                if(cDTyp=='D') 
                    s[i]=srvC[i].DisplayName; 
                else if(cDTyp=='S') 
                    s[i]=srvC[i].ServiceName; 
            } 
        }  
        catch(Exception x){} 
        return s;  
    } 

    //Retrieves a list of  Device Driver Services 
    public  string[] GetDDServicesDetails() 
    { 

        string[] s=null; 
        try 
        { 

            ServiceController[] srvC=ServiceController.GetDevices(); 
            s=new string[srvC.Length]; 
            for(int i=0; i < srvC.Length;i++) 

            { 

                if(cDTyp=='D') 
                    s[i]=srvC[i].DisplayName; 
                else if(cDTyp=='S') 
                    s[i]=srvC[i].ServiceName; 
            } 
        }  
        catch(Exception x){} 
        return s;         

    } 

    //Retrieves a list of Non Device Driver Services 
    //and status 
    public  string[] GetNonDDServicesStatus() 
    { 
        string[] s=null; 
        try 
        { 

            ServiceController[] srvC=ServiceController.GetServices();  
            s=new string[srvC.Length]; 
            for(int i=0; i < srvC.Length; i++) 
            { 
                if(cDTyp=='D') 
                    s[i]=srvC[i].DisplayName + "\t->" +
                    ResolveSrvStatus(srvC[i].Status); 
                else if(cDTyp=='S') 
                    s[i]=srvC[i].ServiceName + "\t->" +
                    ResolveSrvStatus(srvC[i].Status); 
            } 
        }  
        catch(Exception x){} 
        return s;         

    } 

    //Retrieves a list of  Device Driver Services 
    //and  status 
    public  string[] GetDDServicesStatus() 
    { 
        string[] s=null; 
        try 
        { 

            ServiceController[] srvC=ServiceController.GetDevices();  
            s=new string[srvC.Length]; 
            for(int i=0;i < srvC.Length; i++) 
            { 
                if(cDTyp=='D') 
                    s[i]=srvC[i].DisplayName+"\t->" +
                    ResolveSrvStatus(srvC[i].Status); 
                else if(cDTyp=='S') 
                    s[i]=srvC[i].ServiceName+"\t->" +
                    ResolveSrvStatus(srvC[i].Status); 
            } 
        }  
        catch(Exception x){} 
        return s; 
    } 
    //Checks for particular service exists or not 
    public string FindService(string s) 
    { 

        string s3=null; 
        try 
        { 

            ServiceController[] services; 
            services = ServiceController.GetServices(); 
            for(int i = 0; i <  services.Length; i++) 
            { 
                if(services[i].ServiceName==s) 
                { 

                    s3="Found"; 
                    break; 
                } 

            } 

        }  
        catch(Exception x){} 
        if(s3==null) 
            return s3="Not Found"; 
        else 
            return s3;  
    } 
    private string ResolveSrvStatus(ServiceControllerStatus sl) 
    { 
        string st=""; 
        if(sl==ServiceControllerStatus.ContinuePending) 
            st="The service continue is pending."; 
        if(sl==ServiceControllerStatus.Paused) 
            st="The service is paused."; 
        if(sl==ServiceControllerStatus.PausePending) 
            st="The service pause is pending."; 
        if(sl==ServiceControllerStatus.Running) 
            st="The service is running."; 
        if(sl==ServiceControllerStatus.StartPending) 
            st="The service is starting."; 
        if(sl==ServiceControllerStatus.Stopped) 
            st="The service is stopped."; 
        if(sl==ServiceControllerStatus.StopPending) 
            st="The service is not running."; 
        return st; 
    } 

} 

}

Compile the above as a component library to produce ServiceInfoLib.dll and then one can call this component in different clients like Windows Forms, Web Forms or Console applications. I have used a simple Windows Forms application to use this component. To use the component in the client, add a reference in Visual Studio .NET and add using ServiceInfoLib; in the client code and create a instance of the component ( ServiceInfo srv = new ServiceInfo() ) and then use the methods of the component. Following is the code snippet of button click events of the client application

private void bNonDDSrvDet_Click(object sender, System.EventArgs e)
{
    tDisp.Clear(); //textbox

    //Invokes ServiceInfo component Non Device Driver details method
    string[] s=srv.GetNonDDServicesDetails();

    for (inti=0; i<s.Length; i++)
    {
        tDisp.Text+=(s[i]+"\r\n");
    }

}

private void bDDSrvDet_Click(object sender, System.EventArgs e)
{

    tDisp.Clear(); //textbox

    //Invokes ServiceInfo component Device Driver details method
    string[] s=srv.GetDDServicesDetails();
    for(int i=0;i<s.Length;i++)
    {
        tDisp.Text+=(s[i]+"\r\n");
    }

}

private void bNonDDSrvStat_Click(object sender, System.EventArgs e)
{

    tDisp.Clear();//textbox

    //Invokes ServiceInfo component Non Device Driver status method
    string[] s=srv.GetNonDDServicesStatus();
    for(int i=0;i<s.Length;i++)
    {
        tDisp.Text+=(s[i]+"\r\n");
    }
}


private void bDDSrvStat_Click(object sender, System.EventArgs e)
{
    tDisp.Clear();    //textbox 
    
    //Invokes ServiceInfo component Device Driver status method
    string[] s=  srv.GetDDServicesStatus();
    for(int i=0;i<s.Length;i++)
    {
        tDisp.Text+=(s[i]+"\r\n");
    }
}

private void bDDSrvFind_Click(object sender, System.EventArgs e)
{
    tDisp.Clear(); //textbox 

    //check for Alerter service exists or not 
    tDisp.Text=srv.FindService("Alerter");
}

//setting the Display type property of ServiceInfo component 
private void rbDispName_CheckedChanged(object sender, System.EventArgs e)
{
    srv.DisplayType='D'; //friendly Display Name 
}

//setting the Display type property of ServiceInfo component
private void rbSrvName_CheckedChanged(object sender, System.EventArgs e)
{
    srv.DisplayType='S'; // Actual instance Service Name 
} 

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Chandra Hundigam
Architect
United States United States
Chandra Hundigam has Master degree in Computer Application, Microsoft Certified Professional and Software Architect. He's significantly involved in enterprise application development and distributed object oriented system development using Microsoft .Net, Sun Java/J2EE technology to serve global giants in the Media, Finance, Mortgage and Software Industries.Presently working as Independent Software Consultant for a US-based company.His areas of interests are in emerging Technologies.

Comments and Discussions

 
GeneralChange User Name and Password Pin
Hercules016-Sep-04 20:51
memberHercules016-Sep-04 20:51 
QuestionAre C# services able to pause? Pin
scotmc8-Aug-03 20:02
memberscotmc8-Aug-03 20:02 
QuestionWhy not include a project/solution file with it??? Pin
Zhefu Zhang25-Apr-03 9:46
memberZhefu Zhang25-Apr-03 9:46 
GeneralNT/2000/C++ Pin
yaronkl27-Sep-02 21:58
memberyaronkl27-Sep-02 21:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150520.1 | Last Updated 26 Sep 2002
Article Copyright 2002 by Chandra Hundigam
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid