Windows服务程序C++怎么正确编写服务主函数

浅磊吖_5519

浅磊吖_5519

2026-10-05

276人浏览

原创

servicemain函数必须严格使用void winapi servicemain(dword dwargc, lptstr *lpszargv)签名,不可自定义名称或返回类型;它由startservicectrldispatcher按名查找调用,需立即注册控制处理器、分步上报状态(如service_start_pending→service_running),并在30秒内完成初始化,否则scm将终止进程。

windows服务程序c++怎么正确编写服务主函数

服务主函数必须用 ServiceMain 命名且符合特定签名

Windows 服务进程启动后,StartServiceCtrlDispatcher 会按名称查找并调用 ServiceMain 函数。它不是任意命名的入口,也不能返回 int 或接受命令行参数。签名必须是:

VOID WINAPI ServiceMain(DWORD dwArgc, LPTSTR *lpszArgv);

常见错误是写成 main() 风格或加 __stdcall 拼写错误(如 WINAPI 写成 WINALPI),导致服务启动失败且事件日志只报“服务未及时响应启动请求”。

  • dwArgc 是服务控制管理器传入的参数个数,通常为 1(服务名本身),不包含传统命令行参数
  • lpszArgv[0] 是服务名,可用于多服务共用一个可执行文件时做分发
  • 该函数需尽快调用 RegisterServiceCtrlHandlerEx 设置控制处理器,否则无法响应暂停/停止等指令

服务状态必须主动上报,不能只靠 SetServiceStatus 一次调用

服务处于 SERVICE_START_PENDING 状态时,若 30 秒内未更新状态为 SERVICE_RUNNING,SCM 会直接终止进程。很多初学者在 ServiceMain 开头调一次 SetServiceStatus 就开始执行业务逻辑,结果因初始化耗时过长被杀。

C++ Code Review Master
C++ Code Review Master

组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载
  • 初始化阶段应分步上报:先设 SERVICE_START_PENDING,完成关键资源(如日志句柄、配置加载)后再切到 SERVICE_RUNNING
  • 长时间操作(如网络连接、数据库初始化)建议用独立线程,主线程保持对 SCM 控制消息的响应能力
  • 每次调用 SetServiceStatus 前必须更新 SERVICE_STATUS 结构体中的 dwCheckPoint 和 dwWaitHint,否则状态可能卡住

控制处理器函数里别阻塞,尤其不能用 WaitForSingleObject 等待无限期事件

HandlerEx 函数运行在 SCM 分配的专用线程中,必须快速返回。常见陷阱是在线程里调用 WaitForSingleObject(hMyEvent, INFINITE),导致 SCM 认为服务无响应,后续所有控制请求(包括停止)都被丢弃。

  • 只应在 HandlerEx 中设置全局标志(如 g_ServiceStopRequested = TRUE),具体清理工作交给主业务线程执行
  • 若需等待业务线程退出,应在 ServiceMain 的末尾做,而不是在 HandlerEx 里
  • HandlerEx 返回前必须再次调用 SetServiceStatus 更新状态为 SERVICE_STOP_PENDING,否则 SCM 不会继续等待

调试服务不能双击运行,必须用 sc create + net start 或服务管理器

直接运行 EXE 文件不会触发 SCM 加载流程,ServiceMain 根本不会被调用。调试时若仍想用 Visual Studio,必须手动附加到服务进程(services.msc 启动后查 PID),或者改用控制台模式开发——把服务逻辑封装成独立函数,在 _tmain 中模拟 SCM 调用 ServiceMain。

  • 安装服务命令示例:sc create MySvc binPath= "C:\path\svc.exe" start= auto(注意等号后有空格)
  • 卸载前务必先 sc stop MySvc,否则 sc delete 会失败并提示“服务正在运行”
  • 日志输出不能依赖 printf 或控制台,要用 OutputDebugString 配合 DbgView,或写入文件(注意权限:服务默认以 LocalSystem 运行,对 C:\ 根目录无写入权)
服务最难的部分不是写逻辑,而是理解 SCM 和服务进程之间的双向时序约束:状态上报时机、控制响应延迟、线程模型隔离。漏掉任何一个环节,都会表现为“服务启动后立刻停止”或“停止命令无反应”,而事件日志里往往只有模糊的超时提示。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

windows c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2208

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

999

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

407

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

307

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

386

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1389

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1197

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Conan 2 安装指南
Conan 2 安装指南

共0课时 | 0人学习