Windows 服務程式開發完整指南：核心 API、控制流程與實戰範例

前言

Windows 服務是長期運行於後台、無需用戶登入即可啟動的特殊應用程式。本文系統梳理服務開發核心 API 分類、關鍵流程，並提供完整的 C++ 服務管理範例代碼。

一、服務程式內部核心 API（由服務自身調用）

二、服務管理與配置 API（由管理工具/安裝程式調用）

三、已棄用 API（僅維護舊代碼時參考）

EnumServicesStatus、LockServiceDatabase、QueryServiceLockStatus、QueryServiceStatus、UnlockServiceDatabase。新代碼請使用 Ex 版本。

四、完整服務管理範例

#include 
#include 

// 服務操作封裝
bool Start_Service(LPCWSTR name) {
    SC_HANDLE hSCM = OpenSCManager(NULL, NULL, SC_MANAGER_ALL_ACCESS);
    if (!hSCM) return false;
    SC_HANDLE hSvc = OpenService(hSCM, name, SERVICE_ALL_ACCESS);
    if (!hSvc) { CloseServiceHandle(hSCM); return false; }
    bool ret = StartService(hSvc, 0, NULL);
    CloseServiceHandle(hSvc); CloseServiceHandle(hSCM);
    return ret;
}

bool Stop_Service(LPCWSTR name) {
    SC_HANDLE hSCM = OpenSCManager(NULL, NULL, SC_MANAGER_ALL_ACCESS);
    if (!hSCM) return false;
    SC_HANDLE hSvc = OpenService(hSCM, name, SERVICE_ALL_ACCESS);
    if (!hSvc) { CloseServiceHandle(hSCM); return false; }
    SERVICE_STATUS ss;
    bool ret = ControlService(hSvc, SERVICE_CONTROL_STOP, &ss);
    CloseServiceHandle(hSvc); CloseServiceHandle(hSCM);
    return ret;
}

bool Create_Service(LPCWSTR name, LPCWSTR display, LPCWSTR path) {
    SC_HANDLE hSCM = OpenSCManager(NULL, NULL, SC_MANAGER_ALL_ACCESS);
    if (!hSCM) return false;
    SC_HANDLE hSvc = CreateService(hSCM, name, display, SERVICE_ALL_ACCESS,
        SERVICE_WIN32_OWN_PROCESS, SERVICE_AUTO_START, SERVICE_ERROR_NORMAL,
        path, NULL, NULL, NULL, NULL, NULL);
    CloseServiceHandle(hSvc); CloseServiceHandle(hSCM);
    return hSvc != NULL;
}

void EnumService() {
    SC_HANDLE hSCM = OpenSCManager(NULL, NULL, SC_MANAGER_ENUMERATE_SERVICE);
    if (!hSCM) return;
    DWORD bytesNeeded, count, resume = 0;
    EnumServicesStatusEx(hSCM, SC_ENUM_PROCESS_INFO, SERVICE_WIN32, SERVICE_STATE_ALL,
        NULL, 0, &bytesNeeded, &count, &resume, NULL);
    LPENUM_SERVICE_STATUS_PROCESS pBuf = (LPENUM_SERVICE_STATUS_PROCESS)malloc(bytesNeeded);
    if (EnumServicesStatusEx(hSCM, SC_ENUM_PROCESS_INFO, SERVICE_WIN32, SERVICE_STATE_ALL,
        (LPBYTE)pBuf, bytesNeeded, &bytesNeeded, &count, &resume, NULL)) {
        for (DWORD i = 0; i < count; ++i) {
            wprintf(L"%s\t%s\tState:%d\n", pBuf[i].lpServiceName, pBuf[i].lpDisplayName, pBuf[i].ServiceStatusProcess.dwCurrentState);
        }
    }
    free(pBuf); CloseServiceHandle(hSCM);
}

int wmain() {
    // 測試範例
    // Create_Service(L"MySvc", L"My Test Service", L"C:\\Path\\To\\Svc.exe");
    // Start_Service(L"MySvc");
    // Stop_Service(L"MySvc");
    // Delete_Service(L"MySvc");
    EnumService();
    return 0;
}

五、服務程式架構要點

1. ServiceMain 中初始化資源、創建工作線程、調用 SetServiceStatus(SERVICE_RUNNING)。
2. HandlerEx 處理 SERVICE_CONTROL_STOP：設置停止事件、通知工作線程退出、清理資源、最終 SetServiceStatus(SERVICE_STOPPED)。
3. 啟動類型：SERVICE_AUTO_START（開機自動）、SERVICE_DEMAND_START（手動）、SERVICE_DISABLED（禁用）。
4. 錯誤控制：SERVICE_ERROR_NORMAL（記錄錯誤繼續）、SERVICE_ERROR_SEVERE（最後一次正確配置）、SERVICE_ERROR_CRITICAL（藍屏）。
5. 服務帳號：LocalSystem（高權限，無網絡憑證）、NetworkService/LocalService（受限）、特定用戶帳號（需密碼管理）。

總結

Windows 服務開發核心在於理解 SCM 與服務進程的協議交互：註冊處理器 → 報告狀態 → 響應控制碼。掌握上述 API 體系與範例模板，可快速構建穩健的後台服務程式。