Click here to Skip to main content
Click here to Skip to main content

CServiceHelper

, 20 May 2002
Rate this:
Please Sign up or sign in to vote.
A simple class to install, uninstall, start, stop, pause, continue Win32 services

Introduction

The CServiceHelper class is a class I wrote when I was distributing Service programs and I found that I was repeatedly having to write a program to install the service, another program to uninstall the service and quite often yet another program to start/stop the service. So I wrote a simple class that allows me to easily install, delete, start, stop, pause and continue a Win32 service. The class is very simple in nature and purpose and it is not an exhaustive class in the sense that there are lots of other operations you might want to do with a service. But I have covered the most frequently used operations and if anyone would like to extend this class, they are quite welcome to do so. While installing the service I am only allowing the two most common options - automatic starting and manual starting services. There are other options available and as I already said, I'd be very happy if anyone wants to enhance the class.

CServiceHelper members

BOOL CServiceHelper::Create()

This function is used to install a service on the target machine. It returns true on success and false on failure.

CServiceHelper m_sh;
m_sh.SetServiceDisplayName("Hello Service 2000");
m_sh.SetServiceName("HelloService2000");
m_sh.SetServicePath("D:\\nish\\Hello2000.exe"); 
m_sh.SetAutoStart(true); 
m_sh.Create();

BOOL CServiceHelper::Delete()

This function is used to uninstall a service from the target machine. It returns true on success and false on failure.

CServiceHelper m_sh; 
m_sh.SetServiceName("HelloService2000");
m_sh.Delete();

BOOL CServiceHelper::Start()

This function is used to start a service installed on the target machine. It returns true on success and false on failure.

CServiceHelper m_sh; 
m_sh.SetServiceName("HelloService2000");
m_sh.Start();

BOOL CServiceHelper::Stop()

This function is used to stop a running service installed on the target machine. It returns true on success and false on failure.

CServiceHelper m_sh; 
m_sh.SetServiceName("HelloService2000");
m_sh.Stop();

BOOL CServiceHelper::Pause()

This function is used to pause a running service installed on the target machine. It returns true on success and false on failure.

CServiceHelper m_sh; 
m_sh.SetServiceName("HelloService2000");
m_sh.Pause();

BOOL CServiceHelper::Continue()

This function is used to continue a paused service installed on the target machine. It returns true on success and false on failure.

CServiceHelper m_sh; 
m_sh.SetServiceName("HelloService2000");
m_sh.Continue();

void CServiceHelper::SetServiceName(LPCTSTR str)

This function is used to set the name of the service and must be compulsorily called before any of the major functions are called.

m_sh.SetServiceName("HelloService2000");

void CServiceHelper::SetServiceDisplayName(LPCTSTR str)

This function is used to set the display name of the service. It should be called before calling Create()

m_sh.SetServiceDisplayName("Hello Service 2000");

void CServiceHelper::SetServicePath(LPCTSTR str)

This function is used to set the path to the service executable. It should be called before calling Create()

m_sh.SetServicePath("D:\\nish\\Hello2000.exe"); 

void CServiceHelper::SetAutoStart(BOOL b)

This function is used to set whether the service starts automatically at boot-up or whether it is manually started by the user. Set this to true for automatic starting and false otherwise.

m_sh.SetAutoStart(true); 

Tips

You can actually use an instance of the class to handle multiple services. Just change the members of the m_serviceinfo struct and call the required function. I'll show a simple example below.

CServiceHelper m_sh; 
m_sh.SetServiceName("HelloService2000"); 
m_sh.Stop(); //we stop the old service 
m_sh.SetServiceName("HelloService3000");
m_sh.Start(); //and start the new one

History

Within 6 hours after I had posted this class, I got severely criticized for the non-OOP approach I had adopted. I therefore posted a question on the Lounge and I got very useful replies from several gentlemen like Chris Losinger, John Simmons, Kilowatt, Tim Smith, Nemenja, Michael Butler, James T Johnson to name but a few of those really nice fellows who helped me out in a very kind display of helpful mindedness. I am very thankful to them for helping me correct my errored ways.

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

Nish Sivakumar

United States United States
Nish is a real nice guy who has been writing code since 1990 when he first got his hands on an 8088 with 640 KB RAM. Originally from sunny Trivandrum in India, he has been living in various places over the past few years and often thinks it’s time he settled down somewhere.
 
Nish has been a Microsoft Visual C++ MVP since October, 2002 - awfully nice of Microsoft, he thinks. He maintains an MVP tips and tricks web site - www.voidnish.com where you can find a consolidated list of his articles, writings and ideas on VC++, MFC, .NET and C++/CLI. Oh, and you might want to check out his blog on C++/CLI, MFC, .NET and a lot of other stuff - blog.voidnish.com.
 
Nish loves reading Science Fiction, P G Wodehouse and Agatha Christie, and also fancies himself to be a decent writer of sorts. He has authored a romantic comedy Summer Love and Some more Cricket as well as a programming book – Extending MFC applications with the .NET Framework.
 
Nish's latest book C++/CLI in Action published by Manning Publications is now available for purchase. You can read more about the book on his blog.
 
Despite his wife's attempts to get him into cooking, his best effort so far has been a badly done omelette. Some day, he hopes to be a good cook, and to cook a tasty dinner for his wife.

Comments and Discussions

 
QuestionStart Windows Service with user Account Pinprofessionalaminhosseini26-Apr-13 21:08 
GeneralMy vote of 5 PingroupJetDraft12-Dec-12 17:56 
QuestionError : 1053 with Service application. PinmemberSriphani24-Aug-08 23:43 
AnswerRe: Error : 1053 with Service application. Pinmemberxxl17813-Aug-13 17:20 
i also have the same problem, the service can not start,and get the error code 1053.
i found that BOOL CServiceHelper::Create() is not enough to install application as service,you alose need to add some value to the regedit, for example HKEY_LOCAL_MACHINE\SOFTWARE\Classes\AppID\[ServiceID]
Generalhi nish Pinmemberashu_om25-Apr-07 3:16 
Generalpassing parameters to Service main from another prog...please help Pinmemberhiitsshiva10-Apr-06 21:01 
GeneralIsInstalled PinmemberSohailB18-Sep-05 22:51 
GeneralRe: IsInstalled Pinmembershtorm16-May-06 12:08 
QuestionHow to complie this classes with my W32 console programm? I got too many errors Pinsussflyflyfly11-Apr-05 8:38 
Generaltype of execution file PinmemberAkram Majed21-Jun-04 2:07 
Questioncan not start service ? PinmemberAkram Majed20-Jun-04 22:02 
GeneralCould not start the service PinmemberTommy N25-Feb-04 7:55 
Generallink error Pinmembermafzo5-Aug-03 23:50 
GeneralRe: link error PineditorNishant S7-Aug-03 7:55 
GeneralAAAAAHH !!!! PinmemberMartin Schneider10-Jul-02 4:57 
GeneralRe: AAAAAHH !!!! PinmemberMartin Schneider10-Jul-02 5:12 
GeneralRe: AAAAAHH !!!! PinsubeditorNishant S14-Jul-02 23:46 
GeneralI Like it Nish PinmemberMatt Newman21-May-02 15:36 
GeneralRe: I Like it Nish PinmemberNish - Native CPian21-May-02 15:48 
GeneralRe: I Like it Nish PinmemberMatt Newman22-May-02 10:31 
GeneralRe: I Like it Nish PinsubeditorNishant S14-Jul-02 23:45 
GeneralWell, looks better but... PinmemberAndreas Saurwein21-May-02 12:00 
GeneralRe: Well, looks better but... PinmemberNish - Native CPian21-May-02 15:50 
GeneralRe: Well, looks better but... PinmemberRama Krishna21-May-02 15:55 
GeneralRe: Well, looks better but... PinmemberAndreas Saurwein21-May-02 21:40 

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 | Mobile
Web02 | 2.8.140814.1 | Last Updated 21 May 2002
Article Copyright 2002 by Nish Sivakumar
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid