A Windows Service Application

작성자 admin 작성일자 25th 1월 2017

This is a simple Windows based services application which is created using Win32 – VC++. The usage of this application is – it will act as a Windows service which is able to fork and monitor any number of sub processes which are running under this service. The applications can be of any type like GUI, non-GUI etc.
This application will help you know about the following topics related to a service application:

How to create/install a new Windows Service.
How to map some applications to a particular Windows Service, and control the application by the service. (How to connect to the Control Service Manager.)
How to start/run Window services.
How to stop/kill Window services.
How to uninstall Windows services.

Code Usage

The code is very simple, and for the most part, self-explanatory. The application executable is given the name “WinService.exe“. The user has to pass some command line arguments while executing this application, through the command prompt to make use of its different features.
Hide Copy Code

WinService.zip

""ApplicationName  FeatureExtension"

Note: The default service name would be “Sundar_Service”. The user can change the service name in the code and rebuild the application.

Feature Extensions

Hide Copy Code

ApplicationName -i  / -I - Create / Install New service
ApplicationName - Connect to Service Control Manager
ApplicationName -s / -S - Run / Start the service
ApplicationName -k / -K - Stop / End the service
ApplicationName -u / -U - Uninstall / Kill the service from windows

Create / Install New Service

Hide Copy Code

"WinService -i" or "WinService -I"

When you type the above line on the command prompt and press Enter, you are able to view a new service in the Windows Services window with the name “Sundar_Service”.
Hide Copy Code

VOID Install(char* pPath, char* pName);

The Install method creates a service object and adds it to the specified service control manager database.
Hide Copy Code

SC_HANDLE schService = CreateService(
            schSCManager,     /* SCManager database      */
            pName,            /* name of service         */
            pName,            /* service name to display */
            SERVICE_ALL_ACCESS,  /* desired access       */
            SERVICE_WIN32_OWN_PROCESS|
              SERVICE_INTERACTIVE_PROCESS , /* service type  */
            SERVICE_AUTO_START,   /* start type              */
            SERVICE_ERROR_NORMAL, /* error control type      */
            pPath,                /* service's binary        */
            NULL,                 /* no load ordering group  */
            NULL,                 /* no tag identifier       */
            NULL,                 /* no dependencies         */
            NULL,                 /* LocalSystem account     */
            NULL        );        /* no password             */

Connect to SCM (Service Control Manager)

Hide Copy Code

"WinService" or "WinService"

While executing the above command on the command prompt, the child processes which are mapped under the service “Sundar_Service” will get started. And these processes will be monitored by the service, so that the application can be started again if it gets killed for any reason.
Hide Copy Code

VOID ExecuteSubProcess();

The “ExecuteSubProcess” method is defined with the “_beginthread” method for thread creation, which ensures the child process continues execution till the service is stopped by the user or Windows. This will also call the “StartServieCtrlDispatcher” method.
Hide Copy Code

if(!StartServiceCtrlDispatcher(lpServiceStartTable))

The “StartServiceCtrlDispatcher” connects the main thread of a service process to the service control manager, which causes the thread to be the service control dispatcher thread for the calling process.
Hide Copy Code

VOID WINAPI ServiceMain(DWORD dwArgc, LPTSTR *lpszArgv)

The callback functionality mapped through the lpServiceStartTable structure will register the “ServiceHandler” method to the service and update its status. Also, this will execute its child applications.
Hide Copy Code

VOID WINAPI ServiceHandler(DWORD fdwControl)

The “ServieHandler” method will control service functions, like “Start”, “Stop”, “Pause” etc.
Note: Child applications are attached as “1.exe“, “2.exe“, “3.exe“, and “4.exe” where the user can update or change the application. This sample application will animate an icon on the system tray of Windows.

Run / Start Service

Hide Copy Code

"WinService -s" or "WinService -S"

When the above line is executed on the command prompt, the service “Sundar_Service” will be started.
Hide Copy Code

VOID RunService(char* pPath, char* pName)

The user-defined RunService method will use the “StartService” method to start a service after getting the service control manager control handle and the service handle.
Hide Copy Code

if(StartService(schService, 0, (const char**)NULL))

Stop / End Windows Service

Hide Copy Code

"WinService -k" or "WinService -K"

This command will stop the service by sending the “SERVICE_CONTROL_STOP” control code to service the control manager using the “ControlService” method. This will lead to executing the user case functionality in the “ServiceHandler” method to stop the service.
Hide Copy Code

if(ControlService(schService,SERVICE_CONTROL_STOP,&status))

Uninstall / Kill the Service from Windows

Hide Copy Code

"WinService -u" or "WinService -U"

This command will uninstall the service from the Windows Service Manager database, after all its child processes have been stopped.
Hide Copy Code

if(!DeleteService(schService))

The “DeleteService” method marks the specified service for deletion from the service control manager database.

Logger

Hide Copy Code

VOID WriteLog(char* pFile, char* pMsg)

The “WriteLog” method would log all the errors and the status of the service in the application path as “Sundar_Service.Log“, with the service name as the log file name