Windows系统服务开发指南

什么是Windows服务

Windows服务（Windows Service）是一种在操作系统后台运行的特殊程序，具有以下特点：

• 可以在系统启动时自动运行，无需用户登录
• 以系统账户或指定用户账户运行，拥有较高权限
• 不依赖于用户会话，即使用户注销也不会停止
• 可通过服务管理器（services.msc）进行管理

服务开发基本结构

一个标准的Windows服务程序包含以下关键组件：

• main() 函数：程序入口，调用 StartServiceCtrlDispatcher
• ServiceMain()：服务主函数，执行核心逻辑
• ServiceCtrlHandler()：处理来自服务控制管理器（SCM）的控制请求

核心代码示例

#include <windows.h>
#include <stdio.h>

SERVICE_STATUS ServiceStatus;
SERVICE_STATUS_HANDLE hStatus;

void ServiceMain(int argc, char** argv);
void ControlHandler(DWORD request);
int InitService();

#define SVCNAME TEXT("MySampleService")

int main() {
    SERVICE_TABLE_ENTRY ServiceTable[2];
    ServiceTable[0].lpServiceName = SVCNAME;
    ServiceTable[0].lpServiceProc = (LPSERVICE_MAIN_FUNCTION)ServiceMain;
    ServiceTable[1].lpServiceName = NULL;
    ServiceTable[1].lpServiceProc = NULL;

    // 启动服务控制分发器
    if (StartServiceCtrlDispatcher(ServiceTable) == FALSE) {
        return GetLastError();
    }
    return 0;
}

void ServiceMain(int argc, char** argv) {
    ServiceStatus.dwServiceType = SERVICE_WIN32;
    ServiceStatus.dwCurrentState = SERVICE_START_PENDING;
    ServiceStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP | SERVICE_ACCEPT_SHUTDOWN;
    ServiceStatus.dwWin32ExitCode = 0;
    ServiceStatus.dwServiceSpecificExitCode = 0;
    ServiceStatus.dwCheckPoint = 0;
    ServiceStatus.dwWaitHint = 0;

    hStatus = RegisterServiceCtrlHandler(SVCNAME, (LPHANDLER_FUNCTION)ControlHandler);
    if (hStatus == (SERVICE_STATUS_HANDLE)0) {
        return;
    }

    // 初始化服务
    if (InitService() == FALSE) {
        ServiceStatus.dwCurrentState = SERVICE_STOPPED;
        ServiceStatus.dwWin32ExitCode = -1;
        SetServiceStatus(hStatus, &ServiceStatus);
        return;
    }

    // 服务正在运行
    ServiceStatus.dwCurrentState = SERVICE_RUNNING;
    SetServiceStatus(hStatus, &ServiceStatus);

    // 主循环（可替换为实际业务逻辑）
    while (ServiceStatus.dwCurrentState == SERVICE_RUNNING) {
        Sleep(1000);
    }
    return;
}

void ControlHandler(DWORD request) {
    switch (request) {
        case SERVICE_CONTROL_STOP:
        case SERVICE_CONTROL_SHUTDOWN:
            ServiceStatus.dwWin32ExitCode = 0;
            ServiceStatus.dwCurrentState = SERVICE_STOPPED;
            SetServiceStatus(hStatus, &ServiceStatus);
            return;
        default:
            break;
    }
    SetServiceStatus(hStatus, &ServiceStatus);
}

int InitService() {
    // 创建日志文件用于调试
    FILE* fp = fopen("C:\\Temp\\service.log", "w");
    if (fp == NULL) return FALSE;
    fprintf(fp, "Service initialized.\n");
    fclose(fp);
    return TRUE;
}
            

服务的安装与卸载

使用命令行工具 sc 来管理服务：

• 安装服务：sc create MySampleService binPath= "C:\path\to\your\service.exe"
• 启动服务：sc start MySampleService
• 停止服务：sc stop MySampleService
• 删除服务：sc delete MySampleService

注意：服务可执行文件路径中的空格需要正确处理，建议使用引号包围路径。

开发注意事项

• 服务不应有用户界面，所有输出应记录到日志文件或事件日志
• 确保服务能正确处理停止和关闭请求，避免系统关机延迟
• 使用事件日志（Event Log）记录运行状态和错误信息
• 避免在服务中执行长时间阻塞操作，应使用多线程或异步处理
• 权限管理：根据需要配置服务运行账户（LocalSystem, NetworkService等）