五个步骤讲述C语言编写Windows服务程序
Windows服务被豹肉钕舞设计用于需要在后台运行的应用程序以及实现没有用户交互的任务为了学习这种控制台应用程序的基础知识,C(不是C++)是最佳选择
本文将建立并实现一个简单的服务程序,其功能是查询系统中可用物理内存数量,然后将结果写入一个文本文件最后,你可以用所学知识编写自己的Windows服务
当初我写第一个NT服务时,我到MSDN上找例子在那里我找到了一篇NigelThompson写的文章:“CreatingaSimpleWin32ServiceinC++”,这篇文章附带一个C++例子虽然这篇文章很好地解释了服务的开发过程,但是,我仍然感觉缺少我需要的重要信息我想理解通过什么框架,调用什么函数,以及何时调用,但C++在这方面没有让我轻松多少面向对象的方法固然方便,但由于用类对底层Win32函数调用进行了封装,它不利于学习服务程序的基本知识这就是为什么我觉得C更加适合于编写初级服务程序或者实现简单后台任务的服务在你对服务程序有了充分透彻的理解之后,用C++编写才能游刃有余当我离开原来的工作岗位,不得不向另一个人转移我的知识的时候,利用我用C所写的例子就非常容易解释NT服务之所以然
服务是一个运行在后台并实现勿需用户交互的任务的控制台程序WindowsNT/2000/XP操作系统提供为服务程序提供专门的支持人们可以用服务控制面板来配置安装好的服务程序,也就是Windows2000/XP控制面板|管理工具中的“服务”(或在“开始”|“运行”对话框中输入services.msc/s——译者注)可以将服务配置成操作系统启动时自动启动,这样你就不必每次再重启系统后还要手动启动服务
本文将首先解释如何创建一个定期查询可用物理内存并将结果写入某个文本文件的服务然后指导你完成生成,安装和实现服务的整个过程
第一步:主函数和全局定义
首先,包含所需的头文件例子要调用Win32函数(windows.h)和磁盘文件写入(stdio.h):
#include
#include
接着,定义两个常量:
#defineSLEEP_TIME5000
#defineLOGFILE"C:\\MyServices\\memstatus.txt"
SLEEP_TIME指定两次连续查询可用内存之间的毫秒间隔在第二步中编写服务工作循环的时候要使用该常量
LOGFILE定义日志文件的路径,你将会用WriteToLog函数将内存查询的结果输出到该文件,WriteToLog函数定义如下:
intWriteToLog(char*str){FILE*log;log=fopen(LOGFILE,"a+");if(log==NULL)return-1;fprintf(log,"%s\n",str);fclose(log);return0;}
声明几个全局变量,以便在程序的多个函数之间共享它们值此外,做一个函数的前向定义:
SERVICE_STATUSServiceStatus;
SERVICE_STATUS_HANDLEhStatus;
voidServiceMain(intargc,char**argv);
voidControlHandler(DWORDrequest);
intInitService();
现在,准备工作已经就绪,你可以开始编码了服务程序控制台程序的一个子集因此,开始你可以定义一个main函数,它是程序的入口点对于服务程序来说,main的代码令人惊讶地简短,因为它只创建分派表并启动控制分派机
voidmain(){SERVICE_TABLE_ENTRYServiceTable[2];ServiceTable[0].lpServiceName="MemoryStatus";ServiceTable[0].lpServiceProc=(LPSERVICE_MAIN_FUNCTION)ServiceMain;
ServiceTable[1].lpServiceName=NULL;ServiceTable[1].lpServiceProc=NULL;
//启动服务的控制分派机线程StartServiceCtrlDispatcher(ServiceTable);}
一个程序可能包含若干个服务每一个服务都必须列于专门的分派表中(为此该程序定义了一个ServiceTable结构数组)这个表中的每一项都要在SERVICE_TABLE_ENTRY结构之中它有两个域:
lpServiceName:指向表示服务名称字符串的指针;当定义了多个服务时,那么这个域必须指定;lpServiceProc:指向服务主函数的指针(服务入口点);分派表的最后一项必须是服务名和服务主函数域的NULL指针,文本例子程序中只宿主一个服务,所以服务名的定义是可选的
服务控制管理器(SCM:ServicesControlManager)是一个管理系统所有服务的进程当SCM启动某个服务时,它等待某个进程的主线程来调用StartServiceCtrlDispatcher函数将分派表传递给StartServiceCtrlDispatcher.这将把调用进程的主线程转换为控制分派器该分派器启动一个新线程,该线程运行分派表中每个服务的ServiceMain函数(本文例子中只有一个服务)分派器还监视程序中所有服务的执行情况然后分派器将控制请求从SCM传给服务
注意:如果StartServiceCtrlDispatcher函数30秒没有被调用,便会报错,为了避免这种情况,我们必须在ServiceMain函数中(参见本文例子)或在非主函数的单独线程中初始化服务分派表本文所描述的服务不需要防范这样的情况
分派表中所有的服务执行完之后(例如,用户通过“服务”控制面板程序停止它们),或者发生错误时StartServiceCtrlDispatcher调用返回然后主进程终止
第二步:ServiceMain函数
Listing1展示了ServiceMain的代码该函数是服务的入口点它运行在一个单独的线程当中,这个线程是由控制分派器创建的ServiceMain应该尽可能早早为服务注册控制处理器这要通过调用RegisterServiceCtrlHadler函数来实现你要将两个参数传递给此函数:服务名和指向ControlHandlerfunction的指针
它指示控制分派器调用ControlHandler函数处理SCM控制请求注册完控制处理器之后,获得状态句柄(hStatus)通过调用SetServiceStatus函数,用hStatus向SCM报告服务的状态
Listing1展示了如何指定服务特征和其当前状态来初始化ServiceStatus结构,ServiceStatus结构的每个域都有其用途:
dwServiceType:指示服务类型,创建Win32服务赋值SERVICE_WIN32;
dwCurrentState:指定服务的当前状态因为服务的初始化在这里没有完成,所以这里的状态为SERVICE_START_PENDING;
dwControlsAccepted:这个域通知SCM服务接受哪个域本文例子是允许STOP和SHUTDOWN请求处理控制请求将在第三步讨论;
dwWin32ExitCode和dwServiceSpecificExitCode:这两个域在你终止服务并报告退出细节时很有用初始化服务时并不退出,因此,它们的值为0;
dwCheckPoint和dwWaitHint:这两个域表示初始化某个服务进程时要30秒以上本文例子服务的初始化过程很短,所以这两个域的值都为0.
调用SetServiceStatus函数向SCM报告服务的状态时要提供hStatus句柄和ServiceStatus结构注意ServiceStatus一个全局变量,所以你可以跨多个函数使用它ServiceMain函数中,你给结构的几个域赋值,它们在服务运行的整个过程中都保持不变,比如:dwServiceType.
在报告了服务状态之后,你可以调用InitService函数来完成初始化这个函数只是添加一个说明性字符串到日志文件如下面代码所示:
//服务初始化intInitService(){intresult;result=WriteToLog("Monitoringstarted.");return(result);}
在ServiceMain中,检查InitService函数的返回值如果初始化有错(因为有可能写日志文件失败),则将服务状态置为终止并退出ServiceMain:
error=InitService();if(error){//初始化失败,终止服务ServiceStatus.dwCurrentState=SERVICE_STOPPED;ServiceStatus.dwWin32ExitCode=-1;SetServiceStatus(hStatus,&ServiceStatus);//退出ServiceMainreturn;}
如果初始化成功,则向SCM报告状态:
//向SCM报告运行状态
ServiceStatus.dwCurrentState=SERVICE_RUNNING;
SetServiceStatus(hStatus,&ServiceStatus);
接着,启动工作循环每五秒钟查询一个可用物理内存并将结果写入日志文件
如Listing1所示,循环一直到服务的状态为SERVICE_RUNNING或日志文件写入出错为止状态可能在ControlHandler函数响应SCM控制请求时修改
第三步:处理控制请求
在第二步中,你用ServiceMain函数注册了控制处理器函数控制处理器与处理各种Windows消息的窗口回调函数非常类似它检查SCM发送了什么请求并采取相应行动
每次你调用SetServiceStatus函数的时候,必须指定服务接收STOP和SHUTDOWN请求Listing2示范了如何在ControlHandler函数中处理它们
STOP请求是SCM终止服务的时候发送的例如,如果用户在“服务”控制面板中手动终止服务SHUTDOWN请求是关闭机器时,由SCM发送给所有运行中服务的请求两种情况的处理方式相同:
写日志文件,监视停止;
向SCM报告SERVICE_STOPPED状态;
由于ServiceStatus结构对于整个程序而言为全局量,ServiceStatus中的工作循环在当前状态改变或服务终止后停止其它的控制请求如:PAUSE和CONTINUE在本文的例子没有处理
控制处理器函数必须报告服务状态,即便SCM每次发送控制请求的时候状态保持相同因此,不管响应什么请求,都要调用SetServiceStatus.
第四步:安装和配置服务
程序编好了,将之编译成exe文件本文例子创建的文件叫MemoryStatus.exe,将它拷贝到C:\MyServices文件夹为了在机器上安装这个服务,需要用SC.EXE可执行文件,它是Win32PlatformSDK中附带的一个工具(译者注:VisaulStudio.NET2003IDE环境中也有这个工具,具体存放位置在:C:\ProgramFiles\MicrosoftVisualStudio.NET2003\Common7\Tools\Bin\winnt)使用这个实用工具可以安装和移除服务其它控制操作将通过服务控制面板来完成以下是用命令行安装MemoryStatus服务的方法:
sccreateMemoryStatusbinpath=c:\MyServices\MemoryStatus.exe发出此创建命令指定服务名和二进制文件的路径(注意binpath=和路径之间的那个空格)安装成功后,便可以用服务控制面板来控制这个服务用控制面板的工具栏启动和终止这个服务
MemoryStatus的启动类型是手动,也就是说根据需要来启动这个服务右键单击该服务,然后选择上下文菜单中的“属性”菜单项,此时显示该服务的属性窗口在这里可以修改启动类型以及其它设置你还可以从“常规”标签中启动/停止服务以下是从系统中移除服务的方法:
scdeleteMemoryStatus
指定“delete”选项和服务名此服务将被标记为删除,下次西通重启后,该服务将被完全移除
第五步:测试服务
从服务控制面板启动MemoryStatus服务如果初始化不出错,表示启动成功过一会儿将服务停止检查一下C:\MyServices文件夹中memstatus.txt文件的服务输出在我的机器上输出是这样的:
Monitoringstarted.
273469440
273379328
273133568
273084416
Monitoringstopped.
为了测试MemoryStatus服务在出错情况下的行为,可以将memstatus.txt文件设置成只读这样一来,服务应该无法启动
一.去掉只读属性,启动服务,在将文件设成只读服务将停止执行,因为此时日志文件写入失败如果你更新服务控制面板的内容,会发现服务状态是已经停止以上内容均出自上嵌、转载需告知。