Windows 服务程序(一)-白红宇

Windows 服务程序(一)

阅读量：5235 次

发布时间：2019-06-14

本文共 9968 字，大约阅读时间需要 33 分钟。

Windows 服务程序简介：

Windows服务应用程序是一种需要长期运行的应用程序，它对于服务器环境特别适合。

它没有用户界面，并且也不会产生任何可视输出。任何用户消息都会被写进Windows事件日志。

因为这些特性，所以特别适用于后台程序。

计算机启动时，服务会自动开始运行。它们不要用户一定登录才运行，它们能在包括这个系统内的任何用户环境下运行。

通过服务控制管理器， Windows服务允许用户创建可在其自身的 Windows 会话中长时间运行的可执行应用程序。

这些服务可在计算机启动时自动启动，可以暂停和重启，并且不显示任何用户界面。

Windows服务应用程序通常可以在本地和通过网络为用户提供一些功能：

例如客户端/服务器应用程序、Web 服务器、数据库服务器以及其他基于服务器的应用程序。

Windows 服务程序如下图右方：

编写 Windows 服务程序：

Windows服务程序有着固定的模式，它一般由四个部分组成：main(), ServiceMain(), ServiceHandle(), MyWork()。

main() 仅负责创建服务分派表并启动控制分派机制，典型代码如下：

int main(void){    SERVICE_TABLE_ENTRYA ServTable[2];    // 创建服务分派表。    ServTable[0].lpServiceName = "Test";  // 服务名称。类似于 Win32 应用程序的窗口名称。每个服务代表一项功能。    ServTable[0].lpServiceProc = (LPSERVICE_MAIN_FUNCTION)ServiceMain;  //服务入口函数。    ServTable[1].lpServiceName = NULL;  // 每一个服务分派表代表一个服务，分派表的最后一项必须是服务名和服务主函数域的 NULL 指针。    ServTable[1].lpServiceProc = NULL;   // 我们称之为“哨兵”（所有值都为NULL），表示该服务表末尾。    StartServiceCtrlDispatcher(ServTable);  // 启动控制分派机制。     return 0;}

SERVICE_TABLE_ENTRYA 结构体：

typedef struct _SERVICE_TABLE_ENTRYA {  LPSTR                    lpServiceName;   // 服务名称。  LPSERVICE_MAIN_FUNCTIONA lpServiceProc;   // 服务入口函数。} SERVICE_TABLE_ENTRYA, *LPSERVICE_TABLE_ENTRYA;

StartServiceCtrlDispatcher() 介绍 :

功能：连接程序主线程到服务控制管理程序。

BOOL StartServiceCtrlDispatcher(  CONST SERVICE_TABLE_ENTRYA *lpServiceStartTable // SERVICE_TABLE_ENTRYA 结构体变量。);

返回值：非零表示成功，零表示失败。

服务控制管理器 (SCM：Services Control Manager) 是一个管理系统所有服务的进程。

当 SCM 启动某个服务时，它等待某个进程的主线程来调用 StartServiceCtrlDispatcher 函数，

将分派表传递给 StartServiceCtrlDispatcher。

这将把调用进程的主线程转换为控制分派器。该分派器启动一个新线程，

该线程运行分派表中每个服务的 ServiceMain 函数分派器还监视程序中所有服务的执行情况。

然后分派器将控制请求从 SCM 传给服务。

分派表中所有的服务执行完之后，或者发生错误时。StartServiceCtrlDispatcher 调用返回。然后主进程终止。

SCM 开始启动一个服务程序时，总是等待这个服务程序去调用 StartServiceCtrlDispatcher()。

而当服务开始运行时，main() 将会调用 ServiceMain(), 直到 ServiceMain() 执行完毕或发生错误而退出，

StartServiceCtrlDispatcher() 返回，主线程将会终止。

ServiceMain() 服务入口函数，它的作用就是：将你需要执行的任务放到该函数中循环执行即可。这就是服务程序的工作函数。

在ServiceMain执行你的任务前，需要给SERVICE_TABLE_ENTRY 分派表结构体进行赋值。

典型代码如下：

// SERVICE_STATUS ServiceStatus;  //这段代码应声明为全局变量，因多处使用。 // SERVICE_STATUS_HANDLE hStatus; //这段代码应声明为全局变量，因多处使用。 void WINAPI ServiceMain(DWORD dwArgc, LPSTR *lpszArgv){   // 初始化状态设置。    ServiceStatus.dwServiceType = SERVICE_WIN32_OWN_PROCESS;        ServiceStatus.dwCurrentState = SERVICE_START_PENDING; // 即服务目前状态为 正在初始化。    ServiceStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP |        SERVICE_ACCEPT_PAUSE_CONTINUE | SERVICE_ACCEPT_SHUTDOWN;     // 这个通知 SCM 服务接收哪个域。本例包含 停止，暂停和继续，关机等命令。    ServiceStatus.dwWin32ExitCode = 0;  // 这个域在终止服务并报告细节时很有用。下面这四个值一般不用关心，通常设置为 0。    ServiceStatus.dwCheckPoint = 0;    // 用来报告它当前的事件进展情况的。    ServiceStatus.dwServiceSpecificExitCode = 0;  // 这个域在终止服务并报告细节时也很有用。    ServiceStatus.dwWaitHint = 0;  // 根据初始化过程的长短而定。    // 注册控制函数。    hStatus = RegisterServiceCtrlHandler("ServiceName",   // 注册服务控制程序，注册成功后将会返回一个服务状态句柄。        (LPHANDLER_FUNCTION)ServiceHandler);  // ServiceHandle 是服务控制程序。类似与 Windows 应用程序的窗口过程。    if (!hStatus)     {
             printf("Register Service Error!\n");         system("pause");        return;      }     SetServiceStatus(hStatus, &ServiceStatus);  // 设置服务状态。通过调用 SetServiceStatus 函数,向 SCM 报告服务的状态。 if (GetLastError != NO_ERROR)  // 返回调用线程最近的错误代码值,检查是否出错。    {        // 如果出错，将其重设为停止状态。        ServiceStatus.dwCurrentState = SERVICE_STOPPED;         ServiceStatus.dwCheckPoint = 0;         ServiceStatus.dwWaitHint = 0;        SetServiceStatus(hStatus, &ServiceStatus);         printf("Start Error!\n");         system("pause");              return;    }     // 没有错误就继续运行。     ServiceStatus.dwCurrentState = SERVICE_RUNNING;     ServiceStatus.dwCheckPoint = 0;     ServiceStatus.dwWaitHint = 0;     SetServiceStatus(hStatus, &ServiceStatus);     // 创建线程执行特定功能     HANDLE hThread = CreateThread(NULL, 0, MyWork, NULL, 0, NULL); // MyWOrk 是特定功能的函数，如后门程序。     if(hThread = NULL)          return;    }

SERVICE_STATUS 结构体：

typedef struct _SERVICE_STATUS {  DWORD dwServiceType;   // 服务类型。  DWORD dwCurrentState;   // 服务的当前状态。  DWORD dwControlsAccepted;  // 服务在其处理函数中接受和处理的控制代码。  DWORD dwWin32ExitCode;    // 服务用于报告启动或停止时发生错误的错误代码。  DWORD dwServiceSpecificExitCode;  // 服务在启动或停止时发生错误时返回的错误代码。  DWORD dwCheckPoint;   // 服务在长时间启动、停止、暂停或继续操作期间定期递增以报告其进度的检查点值。  DWORD dwWaitHint;    // 将要进行 开始、停止、暂停或继续服务 操作所需的估计时间 (以毫秒为单位)。} SERVICE_STATUS, *LPSERVICE_STATUS;

dwServiceType 的值：(可组合)

值	含义
SERVICE_FILE_SYSTEM_DRIVER	该服务是一个文件系统驱动程序
SERVICE_KERNEL_DRIVER	该服务是一个设备驱动程序
SERVICE_WIN32_OWN_PROCESS	服务在自己的进程中运行（通常使用这个)
SERVICE_USER_OWN_PROCESS	该服务在登录用户帐户下在其自己的进程中运行

dwCurrentState 的值：

值	含义
SERVICE_CONTINUE_PENDING	服务处于从暂停状态恢复的过程中
SERVICE_PAUSE_PENDING	服务正在暂停过程中，但还有没完全进入暂停状态
SERVICE_PAUSED	服务已经暂停了
SERVICE_RUNNING	服务正在运行了
SERVICE_START_PENDING	服务在启动过程中，但还没有准备好对请求进行响应
SERVICE_STOP_PENDING	服务正在停止过程中，但还没有完全进入停止状态
SERVICE_STOPPED	服务已经停止了

dwControlsAccepted 的值： (可组合)

值	含义
SERVICE_ACCEPT_NETBINDCHANGE	该服务是一个网络组件，并且能够在服务在服务不重启的情况下，改变其所网络接收的绑定，接收SERVICE_CONTROL_NETBINDADD、SERVICE_CONTROL_NETBINDREMOVE、SERVICE_CONTROL_NETBINDENABLE、SERVICE_CONTROL_NETBINDDISABLE 的通知
SERVICE_ACCEPT_PARAMCHANGE	服务在不重启的情况下能够重新读取其配置参数，接收 SERVICE_CONTROL_PARAMCHANGE 通知
SERVICE_ACCEPT_PAUSE_CONTINUE	服务支持暂停和重启，服务能够接收到 SERVICE_CONTROL_PAUSE 和SERVICE_CONTROL_CONTINUE的通知
SERVICE_ACCEPT_PRESHUTDOWN	系统在关闭前，能够收到系统的 SERVICE_CONTROL_PRESHUTDOWN 通知，用来处理一些关闭前的清理，xp之前不支持此控制码
SERVICE_ACCEPT_SHUTDOWN	能够接收系统退出时的 SERVICE_CONTROL_SHUTDOWN 的通知，以便处理一些回收
SERVICE_ACCEPT_STOP	能够接收 SERVICE_CONTROL_STOP 的通知来处理一些回收任务

SetServiceStatus() 介绍：

功能：更新服务控制管理器调用服务的状态信息。

函数原型：BOOL SetServiceStatus(

SERVICE_STATUS_HANDLE hServiceStatus, //服务状态信息结构的句柄, 由 RegisterServiceCtrlHandler() 返回。

LPSERVICE_STATUS lpServiceStatus // 指向 SERVICE_STATUS 结构的指针包含呼叫服务的最新状态信息。

);

返回值：非零表示成功，零表示失败。

RegisterServiceCtrlHandler() 介绍：

功能：注册一个函数以处理服务控制请求。

函数原型：SERVICE_STATUS_HANDLE RegisterServiceCtrlHandler(

LPCSTR lpServiceName, //调用线程运行的服务的名称, 即在 CreateService() 中指定的服务控制程序的服务名称。

LPHANDLER_FUNCTION lpHandlerProc // 指向要注册的处理程序的函数。

);

返回值：如果函数成功, 则返回值为服务状态句柄。如果函数失败, 返回值为零。

CreateThread() 介绍：

功能：该函数在的基础上创建一个新线程。终止运行后，

线程对象仍然在系统中，必须通过 CloseHandle() 来关闭该线程对象。

函数原型：HANDLE CreateThread(

LPSECURITY_ATTRIBUTES lpThreadAttributes,

SIZE_T dwStackSize,

LPTHREAD_START_ROUTINE lpStartAddress,

LPVOID lpParameter,

DWORD dwCreationFlags,

LPDWORD lpThreadId

);

参数：

lpThreadAttributes

指向 SECURITY_ATTRIBUTES 结构的指针, 它确定返回的句柄是否可以由子进程继承。

如果 lpThreadAttributes 为 NULL, 则无法继承句柄。

dwStackSize

堆栈的初始大小 (以字节为单位)。系统将此值舍入到最近的页面。

如果此参数为零, 则新线程将使用可执行文件的默认大小。

lpStartAddress

指向要由线程执行的应用程序定义的函数。此指针表示线程的起始地址。

lpParameter

指向要传递给线程的变量的指针。

dwCreationFlags

控制线程创建的标志。通常情况下为 0。

lpThreadId

指向接收线程标识符的变量的指针。如果此参数为 NULL, 则不返回线程标识符。

返回值：如果函数成功, 则返回值是新线程的句柄。如果函数失败, 返回值为 NULL。

ServiceHandle() 服务控制函数，典型代码如下：

void WINAPI ServiceHandler(DWORD fdwControl){    switch (fdwControl)    {    case SERVICE_CONTROL_PAUSE:        ServiceStatus.dwCurrentState = SERVICE_PAUSED;        break;    case SERVICE_CONTROL_CONTINUE:        ServiceStatus.dwCurrentState = SERVICE_RUNNING;        break;    case SERVICE_CONTROL_STOP:    case SERVICE_CONTROL_SHUTDOWN:        ServiceStatus.dwCurrentState = SERVICE_STOPPED;        ServiceStatus.dwCheckPoint = 0;        ServiceStatus.dwWaitHint = 0;        SetServiceStatus(hStatus, &ServiceStatus);        return;      default:        break;    }    SetServiceStatus(hStatus, &ServiceStatus); // 重设服务状态。    return;}

入门代码如下：(目前的代码仍然不能当做服务来运行，还需要 SCM 进行安装)

#include
      
       #include
       
        SERVICE_STATUS ServiceStatus;SERVICE_STATUS_HANDLE hStatus;void WINAPI ServiceMain(DWORD dwArgc, LPSTR *lpszArgv);void WINAPI ServiceHandler(DWORD fdwControl); DWORD WINAPI MyWork(LPVOID lpParam);int main(void){    SERVICE_TABLE_ENTRY ServTable[2];    ServTable[0].lpServiceName = (LPSTR)"Test";    ServTable[0].lpServiceProc = (LPSERVICE_MAIN_FUNCTION)ServiceMain;    ServTable[1].lpServiceName = NULL;    ServTable[1].lpServiceProc = NULL;    StartServiceCtrlDispatcher(ServTable);    return 0;}void WINAPI ServiceMain(DWORD dwArgc, LPTSTR *lpszArgv){
         ServiceStatus.dwServiceType = SERVICE_WIN32_OWN_PROCESS;    ServiceStatus.dwCurrentState = SERVICE_START_PENDING;    ServiceStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP |        SERVICE_ACCEPT_PAUSE_CONTINUE | SERVICE_ACCEPT_SHUTDOWN;    ServiceStatus.dwWin32ExitCode = 0;    ServiceStatus.dwCheckPoint = 0;    ServiceStatus.dwServiceSpecificExitCode = 0;    ServiceStatus.dwWaitHint = 0;    hStatus = RegisterServiceCtrlHandler("ServiceName",        (LPHANDLER_FUNCTION)ServiceHandler);    if (!hStatus)     {
             printf("Register Service Error!\n");         system("pause");         return;      }     SetServiceStatus(hStatus, &ServiceStatus);    if (GetLastError() != NO_ERROR)    {
             ServiceStatus.dwCurrentState = SERVICE_STOPPED;        ServiceStatus.dwCheckPoint = 0;         ServiceStatus.dwWaitHint = 0;        SetServiceStatus(hStatus, &ServiceStatus);         printf("Start Service Error!\n");         system("pause");         return;    }     ServiceStatus.dwCurrentState = SERVICE_RUNNING;     ServiceStatus.dwCheckPoint = 0;     ServiceStatus.dwWaitHint = 0;     SetServiceStatus(hStatus, &ServiceStatus);     // 从这里开始可以放入你想服务为你所做的事情。     HANDLE hThread = CreateThread(NULL, 0, MyWork, NULL, 0, NULL);     if(hThread = NULL)          return;     }void WINAPI ServiceHandler(DWORD fdwControl){    switch (fdwControl)    {    case SERVICE_CONTROL_PAUSE:        ServiceStatus.dwCurrentState = SERVICE_PAUSED;        break;    case SERVICE_CONTROL_CONTINUE:        ServiceStatus.dwCurrentState = SERVICE_RUNNING;        break;    case SERVICE_CONTROL_STOP:    case SERVICE_CONTROL_SHUTDOWN:        ServiceStatus.dwCurrentState = SERVICE_STOPPED;        ServiceStatus.dwCheckPoint = 0;        ServiceStatus.dwWaitHint = 0;        SetServiceStatus(hStatus, &ServiceStatus);        return; default:        break;    }    SetServiceStatus(hStatus, &ServiceStatus);    return;} DWORD WINAPI MyWork(LPVOID lpParam) {
      return 0; }