queryservicestatus 函数用于查询服务当前状态,需先通过 openservice 获取带 service_query_status 权限的句柄;返回 service_status 结构,其中 dwcurrentstate 表示 service_running、service_stopped 等枚举值;失败时调用 getlasterror 获取 error_access_denied 或 error_invalid_handle 等错误码。

如何用 OpenService 和 QueryServiceStatus 获取服务状态
Windows 服务状态不能靠进程名或 PID 猜,必须走 SCM(Service Control Manager)接口。核心流程是:连接 SCM → 打开服务句柄 → 查询状态。关键函数就是 OpenService 和 QueryServiceStatus,缺一不可。
常见错误是直接调用 OpenService 失败却没检查返回值,或者打开时没指定 SERVICE_QUERY_STATUS 权限——这会导致后续 QueryServiceStatus 返回 ERROR_ACCESS_DENIED。
-
OpenSCManager必须用SC_MANAGER_CONNECT权限,不是SC_MANAGER_ALL_ACCESS(后者需要管理员) -
OpenService的dwDesiredAccess至少要传SERVICE_QUERY_STATUS,否则查不到状态 -
QUERY_SERVICE_STATUS返回的dwCurrentState是枚举值:SERVICE_RUNNING、SERVICE_STOPPED、SERVICE_START_PENDING等,别直接比数字
为什么 GetServiceStatus 总返回失败?
没有这个函数——这是最常见的命名混淆。Windows API 中只有 QueryServiceStatus(注意是 Query,不是 Get),且它不接受服务名字符串,只接受由 OpenService 返回的有效句柄。
典型错误写法:QueryServiceStatus("wuauserv", &status) —— 编译不过,因为函数签名是 BOOL QueryServiceStatus(SC_HANDLE, LPSERVICE_STATUS)。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 必须先调
OpenSCManager(NULL, NULL, SC_MANAGER_CONNECT)获取 SCM 句柄 - 再用该句柄调
OpenService,传入服务短名称(如"wuauserv",不是显示名"Windows Update") - 最后把返回的
SC_HANDLE传给QueryServiceStatus
服务名填错导致 OpenService 返回 NULL 怎么排查?
服务短名称和你在服务管理器里看到的“名称”不一致,比如“Windows Update”对应短名是 "wuauserv"。填错就直接失败,GetLastError() 通常返回 ERROR_SERVICE_DOES_NOT_EXIST。
调试建议:先用命令行确认短名:sc queryex type= service state= all | findstr "SERVICE_NAME:",或用 sc qc <em>服务名</em> 查配置。
- 短名区分大小写?不区分,但必须拼写完全一致(空格、下划线都不能错)
- 某些服务(如
"Dhcp")在 Win10/11 中可能被系统保护,即使有权限也可能返回ERROR_ACCESS_DENIED,这时需确认是否以管理员权限运行 - 如果服务根本不存在,
OpenService返回NULL,且GetLastError()是ERROR_SERVICE_DOES_NOT_EXIST,不是逻辑错误
C++ 示例里容易漏掉的资源清理和错误处理
句柄不关闭会泄漏 SCM 连接和服务句柄,多次调用后可能触发系统限制。更隐蔽的问题是:QueryServiceStatus 成功不代表服务正在运行——它只返回当前状态快照,dwCurrentState 可能是 SERVICE_STOP_PENDING 或 SERVICE_CONTINUE_PENDING,这些都算“非运行中”。
- 每次
OpenSCManager后必须配对CloseServiceHandle,哪怕只查一次 -
QueryServiceStatus返回FALSE时,立刻调GetLastError()判断是权限问题还是句柄无效 - 不要假设
dwCurrentState == SERVICE_RUNNING就万事大吉——还要检查dwWaitHint和dwCheckPoint判断是否真稳定运行(尤其启动中服务)
服务状态是瞬时快照,没有“实时监听”机制;如需持续监控,得自己轮询 + 间隔判断,或改用 NotifyServiceStatusChange(Win8+,需额外权限和事件循环)。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










