Windows 服务程序(一

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!
");
        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!
");
        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<stdio.h>
#include<Windows.h>
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!
");
        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!
");
        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;
}