Windows服务程序开发指南-优快云博客

本文详细介绍了Windows服务程序的设计与实现方法，包括服务的基本概念、查看与管理服务的方法、服务程序的主要函数及其功能，以及安装、删除和服务运行的具体步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

什么是服务？

服务也是一种应用程序的类型，与普通程序不同的是，服务程序总是在后台默默运行，用户察觉不到，并且开机时即立刻启动，但在任务管理器中不存在对应的进程。

如何查看服务？

那么既然在任务管理器中不存在相应的进程，我们如何取消服务呢？在“我的电脑”上单击右键，在菜单中选择“管理”->服务和应用程序->服务，就可以看见当前电脑中所有的服务了。在需要停止的服务上右击，选择停止，即可以停止该服务了。

如何添加/删除服务？

"开始"->运行，输入cmd，添加服务命令：sc create 服务名，删除服务命令：sc delete 服务名。

服务程序的编写

在一个服务程序中主要有几个重要的函数：main(入口函数，也可以为其它名字)，ServiceInstall，ServiceUnstall，Service_Main，Service_Ctrl。

以下为main函数：

void main(int argc, char **argv) { SERVICE_TABLE_ENTRY dispatchTable[] = { // SZSERVICENAME为服务名称，service_main为该服务的回调函数 { TEXT(SZSERVICENAME), (LPSERVICE_MAIN_FUNCTION)service_main }, { NULL, NULL } }; // 处理命令行参数 if ( (argc > 1) && ((*argv[1] == '-') || (*argv[1] == '/')) ) { if ( _stricmp( "install", argv[1]+1 ) == 0 ) { InstallService(); } else if ( _stricmp( "remove", argv[1]+1 ) == 0 ) { UnstallService(); } else if ( _stricmp( "debug", argv[1]+1 ) == 0 ) { bDebug = TRUE; DebugService(argc, argv); } else { goto dispatch; } exit(0); } // 如果与以上几个参数皆不吻合，则可能是在服务控制管理器中启动该服务 dispatch: // this is just to be friendly printf( "%s -install to install the service/n", SZAPPNAME ); printf( "%s -remove to remove the service/n", SZAPPNAME ); printf( "%s -debug <params> to run as a console app for debugging/n", SZAPPNAME ); printf( "/nStartServiceCtrlDispatcher being called./n" ); printf( "This may take several seconds. Please wait./n" ); if (!StartServiceCtrlDispatcher(dispatchTable)) AddToMessageLog(TEXT("StartServiceCtrlDispatcher failed.")); } 注：以上的SZSERVICE等变量，可从配置文件或资源中读取。

下面我们就来各个击破以上各个函数吧~

1.建立服务

void installService() { SC_HANDLE schService; SC_HANDLE schSCManager; TCHAR szPath[512]; //得到程序磁盘文件的路径 if(GetModuleFileName(NULL,szPath,512)==0) { _tprintf(TEXT("Unable to install %s - %s /n"), TEXT(SZAPPNAME), GetLastError());//@1获取调用函数返回的最后错误码 return; } //打开服务管理数据库 schSCManager=OpenSCManager( NULL, //本地计算机 NULL, //默认的数据库 SC_MANAGER_ALL_ACCESS //要求所有的访问权 ); if(schSCManager) { //登记服务程序 schService=CreateService( schSCManager, //服务管理数据库句柄 TEXT(SZSERVICENAME), //服务名 TEXT(SZAPPNAME), //用于显示服务的标识 SERVICE_ALL_ACCESS, //响应所有的访问请求 SERVICE_WIN32_OWN_PROCESS, //服务类型 SERVICE_DEMAND_START, //启动类型 SERVICE_ERROR_NORMAL, //错误控制类型 szPath, //服务程序磁盘文件的路径 NULL, //服务不属于任何组 NULL, //没有tag标识符 NULL, //启动服务所依赖的服务或服务组,这里仅仅是一个空字符串 NULL, //LocalSystem 帐号 NULL); if(schService) { _tprintf(TEXT("%s installed. /n"),TEXT(SZAPPNAME)); CloseServiceHandle(schService); } else { _tprintf(TEXT("CreateService failed - %s /n"),GetLastError()); } CloseServiceHandle(schSCManager); } else _tprintf(TEXT("OpenSCManager failed - %s /n"),GetLastError()); }

2.删除服务

void UnstallService() { SC_HANDLE schService; SC_HANDLE schSCManager; schSCManager = OpenSCManager( NULL, // machine (NULL == local) NULL, // database (NULL == default) SC_MANAGER_ALL_ACCESS // access required ); if ( schSCManager ) { schService = OpenService(schSCManager, TEXT(theApp.SZSERVICENAME), SERVICE_ALL_ACCESS); if (schService) { // try to stop the service if ( ControlService( schService, SERVICE_CONTROL_STOP, &ssStatus ) ) { _tprintf(TEXT("Stopping %s."), TEXT(theApp.SZSERVICEDISPLAYNAME)); Sleep( 1000 ); while( QueryServiceStatus( schService, &ssStatus ) ) { if ( ssStatus.dwCurrentState == SERVICE_STOP_PENDING ) { _tprintf(TEXT(".")); Sleep( 1000 ); } else break; } if ( ssStatus.dwCurrentState == SERVICE_STOPPED ) _tprintf(TEXT("/n%s stopped./n"), TEXT(theApp.SZSERVICEDISPLAYNAME) ); else _tprintf(TEXT("/n%s failed to stop./n"), TEXT(theApp.SZSERVICEDISPLAYNAME) ); } // now remove the service if( DeleteService(schService) ) _tprintf(TEXT("%s removed./n"), TEXT(theApp.SZSERVICEDISPLAYNAME) ); else _tprintf(TEXT("DeleteService failed - %s/n"), GetLastErrorText(szErr,256)); CloseServiceHandle(schService); } else _tprintf(TEXT("OpenService failed - %s/n"), GetLastErrorText(szErr,256)); CloseServiceHandle(schSCManager); } else _tprintf(TEXT("OpenSCManager failed - %s/n"), GetLastErrorText(szErr,256)); }

3.运行服务

void CmdDebugService(int argc, char ** argv) { DWORD dwArgc; LPTSTR *lpszArgv; #ifdef UNICODE lpszArgv = CommandLineToArgvW(GetCommandLineW(), &(dwArgc) ); #else dwArgc = (DWORD) argc; lpszArgv = argv; #endif _tprintf(TEXT("Debugging %s./n"), TEXT(theApp.SZSERVICEDISPLAYNAME)); SetConsoleCtrlHandler( ControlHandler, TRUE ); // 该函数为你的服务所要真正执行的功能 ServiceStart( dwArgc, lpszArgv ); }

4.Service_main

void WINAPI service_main(DWORD dwArgc, LPTSTR *lpszArgv) { // register our service control handler: // 调用RegisterServiceCtrlHandler函数去通知SCM它的CtrlHandler回调函数的地址 sshStatusHandle = RegisterServiceCtrlHandler( TEXT(SZSERVICENAME), service_ctrl); if (!sshStatusHandle) goto cleanup; // SERVICE_STATUS members that don't change in example // ssStatus.dwServiceType = SERVICE_WIN32_OWN_PROCESS; ssStatus.dwServiceSpecificExitCode = 0; // report the status to the service control manager. // if (!ReportStatusToSCMgr( SERVICE_START_PENDING, // service state NO_ERROR, // exit code 3000)) // wait hint goto cleanup; ServiceStart( dwArgc, lpszArgv ); cleanup: // try to report the stopped status to the service control manager. // if (sshStatusHandle) (VOID)ReportStatusToSCMgr( SERVICE_STOPPED, dwErr, 0); return; } BOOL ReportStatusToSCMgr(DWORD dwCurrentState, DWORD dwWin32ExitCode, DWORD dwWaitHint) { static DWORD dwCheckPoint = 1; BOOL fResult = TRUE; if ( !bDebug ) // when debugging we don't report to the SCM { if (dwCurrentState == SERVICE_START_PENDING) ssStatus.dwControlsAccepted = 0; else ssStatus.dwControlsAccepted = SERVICE_ACCEPT_STOP; ssStatus.dwCurrentState = dwCurrentState; ssStatus.dwWin32ExitCode = dwWin32ExitCode; ssStatus.dwWaitHint = dwWaitHint; if ( ( dwCurrentState == SERVICE_RUNNING ) || ( dwCurrentState == SERVICE_STOPPED ) ) ssStatus.dwCheckPoint = 0; else ssStatus.dwCheckPoint = dwCheckPoint++; // Report the status of the service to the service control manager. // if (!(fResult = SetServiceStatus( sshStatusHandle, &ssStatus))) { AddToMessageLog(TEXT("SetServiceStatus")); } } return fResult; }

5.Service_Ctrl

VOID WINAPI service_ctrl(DWORD dwCtrlCode) { // Handle the requested control code. // switch(dwCtrlCode) { // Stop the service. // // SERVICE_STOP_PENDING should be reported before // setting the Stop Event - hServerStopEvent - in // ServiceStop(). This avoids a race condition // which may result in a 1053 - The Service did not respond... // error. case SERVICE_CONTROL_STOP: ReportStatusToSCMgr(SERVICE_STOP_PENDING, NO_ERROR, 0); // 此处为你的服务结束时需要执行的代码 ServiceStop(); return; // Update the service status. // case SERVICE_CONTROL_INTERROGATE: break; // invalid control code // default: break; } ReportStatusToSCMgr(ssStatus.dwCurrentState, NO_ERROR, 0); }

在调试时，将令行参数设为-debug，则程序直接运行DebugService，因为我们已经提前安装了程序，因此可以正确执行。

而当服务控制管理器中启动服务时，则直接执行Service_main。

5.编写服务程序中遇到的一些问题及用到的一些函数

A：error C2061: syntax error : identifier 'SERVICE_STATUS'
在stdafx.h或其他文件中增加#include <WINSVC.H>

B：ChangeServiceConfig2(service,SERVICE_CONFIG_DESCRIPTION,&info);
修改服务的描述