Simple Windows Service in C++

本文是来自CodeProject中的一篇名为Simple Windows Service in C++的译文,原文地址为:[Simple Windows Service in C++](https://www.codeproject.com/Articles/499465/Simple-Windows-Service-in-Cplusplus),作者...

     

本文是来自CodeProject中的一篇名为Simple Windows Service in C++的译文,原文地址为:[Simple Windows Service in C++](https://www.codeproject.com/Articles/499465/Simple-Windows-Service-in-Cplusplus),作者为:Mohit Arora。
这是一篇使用C++展示如何创建简单的Windows服务的文章。
源代码下载地址为:[Download sample-SampleService](https://www.codeproject.com/KB/system/499465/SampleService.zip)或者[Github地址](https://github.com/ccf19881030/Cplus_libs_wrapper/blob/master/sources/Windows%20VC++%E7%BC%96%E7%A8%8B/VC++%E7%BC%96%E5%86%99Windows%E6%9C%8D%E5%8A%A1%E7%A8%8B%E5%BA%8F/SampleServiceMain.cpp)

## 介绍
这篇文章展示如何使用C++创建一个基本的Windows服务程序。根据应用程序的体系结构,服务在许多开发方案中非常有用。

## 背景
我在C++中找到的Windows服务示例并不多。我使用MSDN编写这个非常基本的Windows服务。

## 使用代码
(1)主入口点(与任何应用程序一样)
(2)服务入口点
(3)服务控制处理程序
你可以使用Visual Studio模板项目来帮助你入门。我刚创建了一个空的Win32控制台应用程序。

在我们开始主入口程序点之前,我们需要声明一些将在整个服务中使用的全局变量。为了更加面向对象,你始终可以创建一个表示服务的类,并使用类成员代表全局变量。为了简单起见,我将使用全局变量。

我们需要一个**SERVICE_STATUS**结构体,将用于向Windows服务控制管理器(SCM)报告服务的状态。

SERVICE_STATUS g_ServiceStatus = {0};
我们同样需要一个**SERVICE_STATUS_HANDLE**句柄,用于在**SCM**注册后引用我们的Windows服务实例。

SERVICE_STATUS_HANDLE g_StatusHandle = NULL;
下面是一些额外的全局变量和函数声明,随着我们的继续将被使用和解释。

SERVICE_STATUS g_ServiceStatus = {0};
SERVICE_STATUS_HANDLE g_StatusHandle = NULL;
HANDLE g_ServiceStopEvent = INVALID_HANDLE_VALUE;

VOID WINAPI ServiceMain (DWORD argc, LPTSTR *argv);
VOID WINAPI ServiceCtrlHandler (DWORD);
DWORD WINAPI ServiceWorkerThread (LPVOID lpParam);

#define SERVICE_NAME _T("My Sample Service")
主函数入口

int _tmain (int argc, TCHAR *argv[])
{
SERVICE_TABLE_ENTRY ServiceTable[] =
{
{SERVICE_NAME, (LPSERVICE_MAIN_FUNCTION) ServiceMain},
{NULL, NULL}
};

if (StartServiceCtrlDispatcher (ServiceTable) == FALSE)
{
return GetLastError ();
}

return 0;
}
在主函数入口点中,你可以快速调用**StartServiceCtrlDispatcher**,以便**SCM**可以调用你的服务入口点(上例中的**ServiceMain**)。 你希望将任何初始化推迟到你接下来定义的服务入口点。

## 服务入口点

VOID WINAPI ServiceMain (DWORD argc, LPTSTR *argv)
{
DWORD Status = E_FAIL;

// Register our service control handler with the SCM
g_StatusHandle = RegisterServiceCtrlHandler (SERVICE_NAME, ServiceCtrlHandler);

if (g_StatusHandle == NULL)
{
goto EXIT;
}

// Tell the service controller we are starting
ZeroMemory (&g_ServiceStatus, sizeof (g_ServiceStatus));
g_ServiceStatus.dwServiceType = SERVICE_WIN32_OWN_PROCESS;
g_ServiceStatus.dwControlsAccepted = 0;
g_ServiceStatus.dwCurrentState = SERVICE_START_PENDING;
g_ServiceStatus.dwWin32ExitCode = 0;
g_ServiceStatus.dwServiceSpecificExitCode = 0;
g_ServiceStatus.dwCheckPoint = 0;

if (SetServiceStatus (g_StatusHandle , &g_ServiceStatus) == FALSE)
{
OutputDebugString(_T(
"My Sample Service: ServiceMain: SetServiceStatus returned error"));
}

/*
* Perform tasks necessary to start the service here
*/

// Create a service stop event to wait on later
g_ServiceStopEvent = CreateEvent (NULL, TRUE, FALSE, NULL);
if (g_ServiceStopEvent == NULL)
{
// Error creating event
// Tell service controller we are stopped and exit
g_ServiceStatus.dwControlsAccepted = 0;
g_ServiceStatus.dwCurrentState = SERVICE_STOPPED;
g_ServiceStatus.dwWin32ExitCode = GetLastError();
g_ServiceStatus.dwCheckPoint = 1;

if (SetServiceStatus (g_StatusHandle, &g_ServiceStatus) == FALSE)
{
OutputDebugString(_T(
"My Sample Service: ServiceMain: SetServiceStatus returned error"));
}
goto EXIT;
}

// Tell the service controller we are started
g_ServiceStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP;
g_ServiceStatus.dwCurrentState = SERVICE_RUNNING;
g_ServiceStatus.dwWin32ExitCode = 0;
g_ServiceStatus.dwCheckPoint = 0;

if (SetServiceStatus (g_StatusHandle, &g_ServiceStatus) == FALSE)
{
OutputDebugString(_T(
"My Sample Service: ServiceMain: SetServiceStatus returned error"));
}

// Start a thread that will perform the main task of the service
HANDLE hThread = CreateThread (NULL, 0, ServiceWorkerThread, NULL, 0, NULL);

// Wait until our worker thread exits signaling that the service needs to stop
WaitForSingleObject (hThread, INFINITE);


/*
* Perform any cleanup tasks
*/

CloseHandle (g_ServiceStopEvent);

// Tell the service controller we are stopped
g_ServiceStatus.dwControlsAccepted = 0;
g_ServiceStatus.dwCurrentState = SERVICE_STOPPED;
g_ServiceStatus.dwWin32ExitCode = 0;
g_ServiceStatus.dwCheckPoint = 3;

if (SetServiceStatus (g_StatusHandle, &g_ServiceStatus) == FALSE)
{
OutputDebugString(_T(
"My Sample Service: ServiceMain: SetServiceStatus returned error"));
}

EXIT:
return;
}
服务主入口点执行以下任务:
(1)初始化我们从主函数入口推迟的任何必要项目。
(2)注册服务控制处理程序,它将处理服务**Stop**,**Pause**,**Continue**,**Shutdown**等控制命令。 这些是通过**SERVICE_STATUS**结构的dwControlsAccepted字段作为位掩码注册的。
(3)将服务状态设置为**SERVICE_PENDING**,然后设置为**SERVICE_RUNNING**。 在任何错误和退出时将状态设置为**SERVICE_STOPPED**。 当状态设置为**SERVICE_STOPPED**或**SERVICE_PENDING**时,始终将**SERVICE_STATUS**.**dwControlsAccepted**设置为0。
(4)执行启动任务。向创建线程/事件/互斥量/IPCs/等。

## 服务控制处理程序

VOID WINAPI ServiceCtrlHandler (DWORD CtrlCode)
{
switch (CtrlCode)
{
case SERVICE_CONTROL_STOP :

if (g_ServiceStatus.dwCurrentState != SERVICE_RUNNING)
break;

/*
* Perform tasks necessary to stop the service here
*/

g_ServiceStatus.dwControlsAccepted = 0;
g_ServiceStatus.dwCurrentState = SERVICE_STOP_PENDING;
g_ServiceStatus.dwWin32ExitCode = 0;
g_ServiceStatus.dwCheckPoint = 4;

if (SetServiceStatus (g_StatusHandle, &g_ServiceStatus) == FALSE)
{
OutputDebugString(_T(
"My Sample Service: ServiceCtrlHandler: SetServiceStatus returned error"));
}

// This will signal the worker thread to start shutting down
SetEvent (g_ServiceStopEvent);

break;

default:
break;
}
}
服务控制处理程序已在你的服务主入口点注册。 每个服务都必须有一个处理程序来处理来自SCM的控制请求。 控制处理程序必须在30秒内返回,否则SCM将返回错误,该错误指出服务没有响应。 这是因为处理程序将在SCM的上下文中调用,并将保持SCM直到它从处理程序返回。
我只实现并支持**SERVICE_CONTROL_STOP**请求。 你可以处理其他请求,例如**SERVICE_CONTROL_CONTINUE**,**SERVICE_CONTROL_INTERROGATE**,**SERVICE_CONTROL_PAUSE**,**SERVICE_CONTROL_SHUTDOWN**以及可以使用**RegisterServiceCtrlHandler(Ex**)函数注册的**Handler**或**HandlerEx**函数支持的其他请求。

## 服务工作线程

DWORD WINAPI ServiceWorkerThread (LPVOID lpParam)
{
// Periodically check if the service has been requested to stop
while (WaitForSingleObject(g_ServiceStopEvent, 0) != WAIT_OBJECT_0)
{
/*
* Perform main service function here
*/

// Simulate some work by sleeping
Sleep(3000);
}

return ERROR_SUCCESS;
}
此示例服务工作线程除了休眠之外什么都不做,并检查服务是否已收到要停止的控制。 一旦收到停止服务的控制信息,服务控制处理程序就会设置**g_ServiceStopEvent**事件。 接着服务工作者线程断开并退出。 这将通知Service Main例程返回并有效地停止服务。

## 安装服务
你可以通过在命令行提示符中运行一下命令来安装服务(**注意要以管理员身份运行**):

C:\>sc create "My Sample Service" binPath= C:\SampleService.exe
在binPath=和值[?]之间需要一个空格。此外,要使用服务可执行程序的绝对路径。
你现在应该在Windows服务控制台中看到该服务。 从这里你可以开始和停止服务。

## 卸载服务
你可以从命令提示符通过运行以下命令卸载服务:

C:\>sc delete "My Sample Service"

## 历史
11/28/2012:文章和代码的初始版本。
11/29/2012:改进了代码并修复了文章示例代码中的一个拼写错误。
2015年11月11日:根据用户评论更新了有关如何安装服务的详细信息。

本文标题为:Simple Windows Service in C++

基础教程推荐