幾乎所有的操作系統(tǒng)在啟動(dòng)的時(shí)候都會(huì)啟動(dòng)一些不需要與用戶交互的進(jìn)程,這些進(jìn)程在Windows中就被稱作服務(wù)。它通常用于實(shí)現(xiàn)客戶/服務(wù)器模式中的服務(wù)器方,如我們常見的Web服務(wù)IIS,當(dāng)操作系統(tǒng)在啟動(dòng)后它就自動(dòng)被運(yùn)行,不管是否有人登陸到系統(tǒng)只要系統(tǒng)開啟它就能得到運(yùn)行。
服務(wù)程序、服務(wù)控制程序(SCP,service control program)和服務(wù)控制管理器(SCM,service control manager)組成了Windows服務(wù)。我們可以通過服務(wù)控制程序操縱服務(wù)控制管理器來配置、啟動(dòng)、暫停、停止服務(wù)程序。其中服務(wù)程序和服務(wù)控制程序可以由我們自己來編寫擴(kuò)展,而服務(wù)控制管理器(\windows\system32\servics.exe)則是操作系統(tǒng)內(nèi)置的一個(gè)部件。首先我們來了解一下SCM的工作情況,然后我們介紹服務(wù)程序的編寫和服務(wù)控制時(shí)所涉及API的使用。
SCM本身也是一個(gè)服務(wù)程序(\windows\system32\servics.exe),作為windows的后臺(tái)服務(wù)運(yùn)行的。Winlogon在系統(tǒng)引導(dǎo)的早期會(huì)將SCM啟動(dòng)起來。SCM的服務(wù)入口函數(shù)首先創(chuàng)建一個(gè)初始化為無信號(hào)的同步事件對(duì)象(SvcCtrlEvent_A3752DX);接下來,它開始建立一個(gè)內(nèi)部服務(wù)數(shù)據(jù)庫,這個(gè)數(shù)據(jù)庫要按事先規(guī)定好的一個(gè)順序列出所有服務(wù)組,并記錄與服務(wù)相關(guān)的詳細(xì)信息;當(dāng)這個(gè)數(shù)據(jù)庫建立完成時(shí)SCM就開始按順序啟動(dòng)那些啟動(dòng)方式為自動(dòng)的服務(wù),如果有服務(wù)要?jiǎng)有杏谥付ㄓ脩糍~戶中時(shí)還要調(diào)用LSASS,如果服務(wù)啟動(dòng)失敗則會(huì)被放入一個(gè)名為ScFailedDrivers的列表中。當(dāng)這些工作都完成后,SCM將同步事件對(duì)象SvcCtrlEvent_A3752DX置為有信號(hào)狀態(tài);并做好系統(tǒng)停機(jī)的準(zhǔn)備。
當(dāng)系統(tǒng)要關(guān)機(jī)時(shí)會(huì)向Windows子系統(tǒng)進(jìn)程Csrss發(fā)送一個(gè)消息,以便調(diào)用Csrss的停機(jī)例程。Csrss會(huì)對(duì)所有活動(dòng)的進(jìn)程循環(huán)通知系統(tǒng)正在停機(jī)。對(duì)于除SCM以外的每一個(gè)系統(tǒng)進(jìn)程如果沒有返回退出的響應(yīng)Csrss 都會(huì)等待由HKEY_USER\.DEFAULT\Control Panel\Desktop\WaitToKillAppTimeout指定的毫秒數(shù)(我的系統(tǒng)中是20000,也就是20秒),然后知通下一個(gè)進(jìn)程結(jié)束。當(dāng)遇到SCM時(shí)也會(huì)通知SCM進(jìn)程系統(tǒng)正在停機(jī),但不同的是會(huì)使用一個(gè)專用的超時(shí)間隔值(SCM在系統(tǒng)初始化時(shí)要向Csrss登記,于是Csrss就將SCM的進(jìn)程ID保存了下來Csrss也就是通過個(gè)ID來識(shí)別SCM的)。這個(gè)專用的超時(shí)間隔位于HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\WaitToKillServiceTimeout中,有趣的是默認(rèn)值也是20秒。這在段時(shí)間里SCM要通知所有在初始化時(shí)(服務(wù)程序自身初始化)請(qǐng)求SCM通知自己系統(tǒng)停機(jī)的服務(wù),SCM有一個(gè)停機(jī)處理器負(fù)責(zé)這項(xiàng)工作。通知下達(dá)后SCM就等待服務(wù)退出,服務(wù)在接收到停機(jī)消息后會(huì)返回給SCM一個(gè)等待時(shí)間,SCM跟蹤所有服務(wù)返回等待時(shí)間找出其中的最大值,當(dāng)這個(gè)最大值達(dá)到后,如果有一個(gè)服務(wù)或多個(gè)服務(wù)又告訴SCM它們正在處理停機(jī)工作,那么SCM還會(huì)循環(huán)等待下去,但Csrss也再等待SCM當(dāng)Csrss等待超時(shí)后,會(huì)繼續(xù)后面的停機(jī)工作最終完成停機(jī)。
這就要求服務(wù)程序要在Csrss等待SCM的這段時(shí)內(nèi)完成自己的停機(jī)處理工作,否則服務(wù)就沒機(jī)會(huì)在系統(tǒng)停機(jī)前完成自己的關(guān)閉工作了。
Windows服務(wù)程序其實(shí)并不神秘,它只是遵循特定規(guī)則編寫的一個(gè)程序。只要遵循這個(gè)特定的規(guī)則與服務(wù)控制管理器正確的交互,就可實(shí)現(xiàn)我們的服務(wù)程序。而我們只要能實(shí)現(xiàn)一個(gè)簡單的服務(wù)程序,設(shè)計(jì)一個(gè)能處理復(fù)雜業(yè)務(wù)的服務(wù)也并非難事,因?yàn)閺慕Y(jié)構(gòu)上看兩者并沒有太大的區(qū)別。只要遵循與SCM交互的規(guī)則,設(shè)計(jì)服務(wù)程序與設(shè)計(jì)普通的應(yīng)用程序幾乎沒什么區(qū)別。
RegisterServiceCtrlHandler完成
Handler函數(shù)的注冊(cè)( Handler函數(shù)的具體實(shí)現(xiàn)我們?cè)诘谌」?jié)中介紹),它的第一個(gè)參數(shù)是調(diào)用
CreateService創(chuàng)建服務(wù)時(shí)
lpServiceName
指向的名服務(wù)名稱,每二個(gè)參數(shù)是
Handler函數(shù)的地址;函數(shù)名可以自由命名
。
ReportStatus是向SCM報(bào)告服務(wù)當(dāng)前狀態(tài)的一個(gè)自定義函數(shù)。它內(nèi)部調(diào)用
SetServiceStatus向SCM報(bào)告服務(wù)的當(dāng)狀態(tài),此函數(shù)有兩個(gè)參數(shù)第一個(gè)就是
RegisterServiceCtrlHandler完成時(shí)返回的SERVICE_STATUS_HANDLE,第二個(gè)參數(shù)是一個(gè)
SERVICE_STATUS
變量的指針,它指示了服務(wù)當(dāng)前的狀態(tài)信息
;當(dāng)注冊(cè)完
Handler函數(shù)后向SCM報(bào)告一下自己當(dāng)前的狀態(tài)(正在啟動(dòng))。接著創(chuàng)建
endEvent事件對(duì)像,它是當(dāng)我們收到SCM的退出控制代碼時(shí)通知服務(wù)主函數(shù)退出的,大家可看
ServiceMain的最后一句。下面又是向SCM報(bào)告自己正在啟動(dòng),當(dāng)初始化所花費(fèi)的時(shí)間非常短時(shí)這樣做并不是必須的,但如果很長就必須這樣做。
RecvParam(argc,argv)使用了
ServiceMain函數(shù)的兩個(gè)參數(shù),大家可以看出
ServiceMain和
main有著一樣的形參;說明
ServiceMain和
main一樣可以接收配置參數(shù),稍后我們會(huì)在服務(wù)控制程序的編寫中給大家介紹如何給服務(wù)配置參數(shù)。
InitService()完成我們的業(yè)務(wù)初始化工作并開始業(yè)務(wù)處理。最后報(bào)告服務(wù)啟動(dòng)完成,等待
endEvent事件退出服務(wù)。下面我們?cè)賮砜匆幌拢樱茫涂刂葡⒌奶幚怼?/div>
(3)SCM控制消息處理(Handler函數(shù))
VOID Handler(DWORD controlCode)
{
DWORD currentState = 0;
BOOL success;
switch(controlCode)
{
case SERVICE_CONTROL_STOP:
success=ReportStatus(SERVICE_STOP_PENDING,NO_ERROR,0,1,5000);
CloseTask();
success=ReportStatus(SERVICE_STOPPED,NO_ERROR,0,0,0);
return;
case SERVICE_CONTROL_PAUSE:
if (runningService&&!pauseService)
{
success=ReportStatus(SERVICE_PAUSE_PENDING,NO_ERROR,0,1,1000);
pauseService=TRUE;
ServicePause();
currentState=SERVICE_PAUSED;
}
break;
case SERVICE_CONTROL_CONTINUE:
if (runningService&&pauseService)
{
success = ReportStatus(SERVICE_CONTINUE_PENDING,
NO_ERROR,0,1,1000);
pauseService = FALSE;
ServiceContinue();
currentState=SERVICE_RUNNING;
}
break;
case SERVICE_CONTROL_INTERROGATE://檢索更新狀態(tài)的時(shí)
break;
case SERVICE_CONTROL_SHUTDOWN://告訴服務(wù)即將關(guān)機(jī)
success=ReportStatus(SERVICE_STOP_PENDING,NO_ERROR,0,1,5000);
CloseTask();
return;
default:
break;
}
ReportStatus(currentState,NO_ERROR,0,0,0);
}
Handler只有一個(gè)參數(shù)就是SCM傳來的控制消息代碼;這里處理的了停止,暫停,繼續(xù),更新,關(guān)機(jī)五個(gè)控制消息。但并不是這五個(gè)消息SCM都會(huì)向服務(wù)發(fā)送,要在向服務(wù)報(bào)告狀時(shí)向SCM報(bào)告自己可以響應(yīng)的控制消息,只要設(shè)置SERVICE_STATUS
結(jié)構(gòu)中的
dwControlsAccepted域即可,它對(duì)應(yīng)的值有:SERVICE_ACCEPT_STOP,SERVICE_ACCEPT_PAUSE_CONTINUE,SERVICE_ACCEPT_SHUTDOWN,當(dāng)要設(shè)置多個(gè)時(shí)只要把宏相或(|)傳給dwControlsAccepted域即可。在響應(yīng)SCM控制消息時(shí)也要注意及時(shí)報(bào)告服務(wù)當(dāng)前的狀態(tài)信息,否則SCM會(huì)認(rèn)為服務(wù)響應(yīng)超時(shí)出錯(cuò)了。
(4)服務(wù)的安裝與卸載
服務(wù)程序編寫完成并編譯通過后,還要安裝注冊(cè)到操作系統(tǒng)中,這樣它才會(huì)出現(xiàn)在管理工具->服務(wù),那個(gè)管理器里面。API給我們提供了一個(gè)函數(shù)來實(shí)現(xiàn)我們注冊(cè)服務(wù)的功能; SC_HANDLE CreateService(
SC_HANDLE
hSCManager
,
//
服務(wù)控制管理器的句柄
LPCTSTR lpServiceName, //
指向服務(wù)的內(nèi)部名稱
LPCTSTR
lpServiceName
,,
//
指向服務(wù)的顯示名稱
DWORD
dwDesiredAccess
,
//
服務(wù)的訪問類型
DWORD
dwServiceType
,
//
服務(wù)的類型
DWORD
dwStartType
,
//
服務(wù)的啟動(dòng)方式(自動(dòng),手動(dòng),禁用)
DWORD
dwErrorControl
,
//
錯(cuò)誤控制方式
LPCTSTR
lpBinaryPathName
,
//
服務(wù)程序的路徑
LPCTSTR
lpLoadOrderGroup
,
//
服務(wù)組的名稱
LPDWORD
lpdwTagId
,
//
服務(wù)的標(biāo)簽號(hào)
LPCTSTR
lpDependencies
,
//
服務(wù)依賴的服務(wù)或組名
LPCTSTR
lpServiceStartName
,
//
服務(wù)的啟動(dòng)帳戶
LPCTSTR
lpPassword
//
服務(wù)啟動(dòng)帳戶的密碼
);
hSCManager
:
這是函數(shù)的第一個(gè)參數(shù)-
SCM的句柄。它要調(diào)用
OpenSCManager
來獲得,稍后我們會(huì)講它怎么調(diào)用方法。
lpServiceName
和
lpServiceName
:
分別的服務(wù)的名稱和服務(wù)的顯示名稱,服務(wù)是顯示名稱就服務(wù)管理器中看到的那個(gè)服務(wù)名。則是服務(wù)在
SCM中注冊(cè)的名稱,比如調(diào)用OpenService打開服務(wù)時(shí)就會(huì)用到它。
dwDesiredAccess
:
標(biāo)出服務(wù)同意請(qǐng)求的訪問,可以是下面任意任值:
SERVICE_ALL_ACCESS
SERVICE_CHANGE_CONFIG
SERVICE_ENUMERATE_DEPENDENTS
SERVICE_INTERROGATE
SERVICE_PAUSE_CONTINUE
SERVICE_QUERY_CONFIG
SERVICE_QUERY_STATUS
SERVICE_START
SERVICE_STOP
SERVICE_USER_DEFINED_CONTROL
我們可以指定一個(gè)或多個(gè),如果有多個(gè)的話要用或符號(hào)(|)聯(lián)結(jié)起來。
dwServiceType
:
注冊(cè)服務(wù)的類型,它必須是下面的值:
SERVICE_WIN32_OWN_PROCESS
SERVICE_WIN32_SHARE_PROCESS
SERVICE_KERNEL_DRIVER
SERVICE_FILE_SYSTEM_DRIVER如果指定的是SERVICE_WIN32_OWN_PROCESS類型的服務(wù)還可以加上SERVICE_WIN32_OWN_PROCESS(允許用戶桌面交互),我們這里介紹的服務(wù)只能注冊(cè)為SERVICE_WIN32_OWN_PROCESS或SERVICE_WIN32_SHARE_PROCESS;另兩種類型是驅(qū)動(dòng)級(jí)的服務(wù)用的,有興趣大家可查看相關(guān)資料。
dwStartType
:
服務(wù)的啟動(dòng)類型
SERVICE_BOOT_START、SERVICE_SYSTEM_START、SERVICE_AUTO_START、SERVICE_DEMAND_START、SERVICE_DISABLED。分別為前兩種類型僅對(duì)驅(qū)動(dòng)程序用效,所在我們這里所說的這類服務(wù)能后三種(自動(dòng),手動(dòng),禁用
)。
dwErrorControl
:
服務(wù)的錯(cuò)誤控制標(biāo)記
SERVICE_ERROR_IGNORE:忽略所有錯(cuò)誤
SERVICE_ERROR_NORMAL:正常報(bào)告服務(wù)返回的錯(cuò)誤
SERVICE_ERROR_SEVERE:當(dāng)服務(wù)返回錯(cuò)誤出現(xiàn)時(shí),如果最后已知好控制集(最后已知好控制集:是系統(tǒng)最后一次成功引導(dǎo)時(shí)使用的服務(wù)注冊(cè)表配置)尚未使用,則重新引導(dǎo)進(jìn)入最后已知好控制集,否則重新引導(dǎo)。
SERVICE_ERROR_CRITICAL:當(dāng)服務(wù)返回錯(cuò)誤出現(xiàn)時(shí),如果最后已知好控制集尚未使用,則重新引導(dǎo)進(jìn)入最后已知好控制集,否則藍(lán)屏崩潰。
lpBinaryPathName
:
服務(wù)程序的文件路徑
lpLoadOrderGroup
:
服務(wù)所屬的組
lpdwTagId
:
在組中的唯一標(biāo)識(shí)
lpDependencies
:
服務(wù)所依賴的其它組和服務(wù)
lpServiceStartName
和lpPassword
:
服務(wù)由哪個(gè)用戶啟動(dòng),也即服務(wù)運(yùn)行在哪個(gè)用戶權(quán)限下,分別指定用戶名和密碼.
下再說兩重要的函數(shù):OpenSCManager和CloseServiceHandle給出它們的原型
SC_HANDLE OpenSCManager(
LPCTSTR
lpMachineName
,
//
機(jī)器名,打開本機(jī)的SCM時(shí)可為NULL
LPCTSTR
lpDatabaseName
,
//
指向SCM數(shù)據(jù)庫的名字可為NULL
DWORD
dwDesiredAccess
//
訪問權(quán)限類型如:
SC_MANAGER_ALL_ACCESS等
);
BOOL CloseServiceHandle(
SC_HANDLE
hSCObject
//
服務(wù)控制句柄
);
這果列出一段注冊(cè)服務(wù)的代碼供大家參考:
SC_HANDLE newService,scm;
BOOL success = FALSE;
SERVICE_STATUS status;
scm = OpenSCManager(NULL,NULL,
SC_MANAGER_ENUMERATE_SERVICE|SC_MANAGER_CREATE_SERVICE);
if (!scm){
OUT_DEBUG("OpenSCManager ERROR!");
return false;
}
newService = CreateService(scm,pszServiceName,pszDisplayName,
SERVICE_ALL_ACCESS|SERVICE_STOP,SERVICE_WIN32_OWN_PROCESS,
SERVICE_AUTO_START,SERVICE_ERROR_NORMAL,pszServicePath,
0,0,0,0,0);
if (!newService){
OUT_DEBUG("CreateService ERROR!");
CloseServiceHandle(scm);
return false;
}
CloseServiceHandle(newService);
CloseServiceHandle(scm);
return true;
刪除服務(wù)時(shí)調(diào)用DeleteService;它只有一個(gè)參數(shù)(服務(wù)句柄)。我們可分四步完成1)、打開SCM句柄。2)、打開要?jiǎng)h除的服務(wù)。3)、檢查當(dāng)前服務(wù)的狀態(tài)確保服務(wù)已經(jīng)停止。4)、刪除服務(wù)并關(guān)閉所有打開的句柄。下面是一段刪除服務(wù)的程序。
SC_HANDLE Service,scm;
SERVICE_STATUS status;
BOOL success;
if (pszServiceName==NULL)
{
return false;
}
scm = OpenSCManager(NULL,NULL,SC_MANAGER_ENUMERATE_SERVICE);
if (!scm){
cout<<"OpenSCManager ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(scm);
return false;
}
Service = OpenService(scm,pszServiceName,SERVICE_ALL_ACCESS|DELETE);
if (!Service){
cout<<"OpenService ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(Service);
CloseServiceHandle(scm);
return false;
}
success = QueryServiceStatus(Service,&status);
if (!success){
cout<<"QueryServiceStatus ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(Service);
CloseServiceHandle(scm);
return false;
}
if (status.dwCurrentState!=SERVICE_STOPPED)
{
success = ControlService(Service,SERVICE_CONTROL_STOP,&status);
if (!success){
cout<<"ControlService ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(Service);
CloseServiceHandle(scm);
return false;
}
}
success = DeleteService(Service);
if (!success){
cout<<"DeleteService ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(Service);
CloseServiceHandle(scm);
return false;
}
CloseServiceHandle(Service);
CloseServiceHandle(scm);
return true;
4 服務(wù)控制程序
4.1 服務(wù)控制程序概要
在上面我們了解服務(wù)程序的編寫,現(xiàn)在我們來看一下控制服務(wù)時(shí)會(huì)用到的幾個(gè)常用API。服務(wù)控制程序的編寫與標(biāo)準(zhǔn)的Windows應(yīng)用程序無異,它要用到服務(wù)管理函數(shù),如:OpenSCManager
、OpenService、QueryServiceConfig、StartService、QueryServiceStatus、ControlService等;它都在系統(tǒng)的
advapi32.dll中實(shí)現(xiàn)。在使用SCM的函數(shù)時(shí),SCP必須要首先調(diào)用OpenSCManager
函數(shù),打開一個(gè)通向SCM的通道。調(diào)用這個(gè)函數(shù)的時(shí)候,SCP還必須指定它想要執(zhí)行的動(dòng)作類型;也就是我們上一節(jié)所提到的
dwDesiredAccess
參數(shù)它的取值:
SC_MANAGER_ALL_ACCESS、SC_MANAGER_CREATE_SERVICE、SC_MANAGER_ENUMERATE_SERVICE、 SC_MANAGER_QUERY_LOCK_STATUS、SC_MANAGER_ENUMERATE_SERVICE 、SC_MANAGER_QUERY_LOCK_STATUS、 SC_MANAGER_LOCK、SC_MANAGER_CONNECT。例如:我們要枚舉當(dāng)前所有的服務(wù)就必須給dwDesiredAccess
參數(shù)指定
SC_MANAGER_ENUMERATE_SERVICE;同時(shí)也可以指定其它的值,當(dāng)指寫多個(gè)值時(shí)我們要把它用按位或(|)符號(hào)連接起來。
與此同時(shí)我們?cè)谡{(diào)用OpenService
時(shí)也必須告知SCM我們要對(duì)服務(wù)進(jìn)行的動(dòng)作;它有三個(gè)參數(shù),最后一個(gè)參數(shù)
dwDesiredAccess
指出要對(duì)服務(wù)進(jìn)行的操作,這些操作的標(biāo)記與CreateService中的dwDesiredAccess參數(shù)標(biāo)記值一樣。當(dāng)我們以
SERVICE_ALL_ACCESS訪問權(quán)限打開服務(wù)后就可以對(duì)它進(jìn)行配置(QueryServiceConfig)、控制(ControlService)、查詢狀態(tài)(QueryServiceStatus)、設(shè)置狀態(tài)(SetServiceStatus)、刪除(DeleteService)等所有訪問操作。下面我們可以來看兩服務(wù)控制的實(shí)例。
4.2
枚舉服務(wù)
我們先來看EnumDependentStatus
函數(shù)原型:
BOOL EnumServicesStatus (
SC_HANDLE
hService
,
// SCM
控制句柄
DWORD
dwServiceType
,
//
要枚舉服務(wù)還有驅(qū)動(dòng)
DWORD
dwServiceState
,
//
要枚舉什么狀態(tài)的服務(wù)
LPENUM_SERVICE_STATUS
lpServices
,
//
存儲(chǔ)枚舉出服務(wù)的內(nèi)存地址
DWORD
cbBufSize
,
// lpServices
指向
內(nèi)存區(qū)大小
LPDWORD
pcbBytesNeeded
,
//
實(shí)際需要的內(nèi)存大小
LPDWORD
lpServicesReturned
//
返回枚舉到服務(wù)年個(gè)數(shù)
LPDWORD
lpResumeHandle
//
指向下一個(gè)有效的入口
);
dwServiceState
參數(shù)由:
SERVICE_ACTIVE、SERVICE_INACTIVE、SERVICE_STATE_ALL三種值分別枚舉當(dāng)前活動(dòng)、不活動(dòng)、全部的服務(wù)。函數(shù)會(huì)返回一個(gè)ENUM_SERVICE_STATUS
的
數(shù)組,ENUM_SERVICE_STATUS
有三個(gè)域分別指出服務(wù)的服務(wù)名、顯示名和當(dāng)前狀態(tài)一個(gè)指針;我們可以根據(jù)服務(wù)名打開枚舉出的服務(wù),以得到它更加詳細(xì)的信息
。下面具體讓我們看一段程序的例子。
//清空服務(wù)信息隊(duì)列
DeletItemAll();
LPENUM_SERVICE_STATUS st=NULL;
st=NULL;
DWORD ret=0;
DWORD size=0;
ServiceInfo info;
SC_HANDLE sc=OpenSCManager(NULL,NULL,SC_MANAGER_ALL_ACCESS);
SC_HANDLE sh;
char* szInfo[1024*8];
DWORD dwSize=1024*8;
CString str;
//第一次調(diào)用來得到需要多大的內(nèi)存區(qū)
EnumServicesStatus(sc,SERVICE_WIN32,SERVICE_STATE_ALL,st,size,&size,&ret,NULL);
//申請(qǐng)需要的內(nèi)存
st=(LPENUM_SERVICE_STATUS)LocalAlloc(LPTR,size);
EnumServicesStatus(sc,SERVICE_WIN32,SERVICE_STATE_ALL,st,size,&size,&ret,NULL);
//開始記錄枚舉出服務(wù)的信息
for(DWORD i=0;i<ret;i++){
dwSize=1024*8;
ZeroMemory(szInfo,dwSize);
info.Name.Format("%s",st[i].lpDisplayName);
info.serviceNmae.Format("%s",st[i].lpServiceName);
info.State.Format("%d",st[i].ServiceStatus.dwCurrentState);
sh=OpenService(sc,st[i].lpServiceName,SERVICE_ALL_ACCESS);
//得到服務(wù)描述信息
QueryServiceConfig2(sh,SERVICE_CONFIG_DESCRIPTION,(LPBYTE)szInfo,dwSize,&dwSize);
info.Desc.Format("%s",((LPSERVICE_DESCRIPTION)szInfo)->lpDescription);
//得到服務(wù)的啟動(dòng)賬戶名
ZeroMemory(szInfo,dwSize);
dwSize=1024*8;
QueryServiceConfig(sh,(LPQUERY_SERVICE_CONFIG)szInfo,dwSize,&dwSize);
info.LoginUser.Format("%s",((LPQUERY_SERVICE_CONFIG)szInfo)->lpServiceStartName);
CloseServiceHandle(sh);
//添加到信息隊(duì)列中
ItemAdd(&info);
}
CloseServiceHandle(sc);
return TRUE;
上面程序中用到了兩個(gè)查詢服務(wù)當(dāng)前配置的函數(shù)QueryServiceConfig2和QueryServiceConfig。它們有所不同是QueryServiceConfig2可以通過設(shè)置第二個(gè)參數(shù)是SERVICE_CONFIG_DESCRIPTION還是SERVICE_CONFIG_FAILURE_ACTIONS來得到服務(wù)的描述信息和失敗的活動(dòng);而QueryServiceConfig則查詢返回一個(gè)QUERY_SERVICE_CONFIG
結(jié)構(gòu),這個(gè)結(jié)構(gòu)存儲(chǔ)了服務(wù)的類型、啟動(dòng)類型、錯(cuò)誤控制標(biāo)記、服務(wù)文件所在路徑、顯示名等信息詳細(xì)可以查看MSDN。與這個(gè)兩函數(shù)相對(duì)應(yīng)還有兩個(gè)配置函數(shù)ChangeServiceConfig2和ChangeServiceConfig。它們的具體使用方法我們來看下面的這段程序。
4.3
配置服務(wù)
在3.2中我們舉了一個(gè)創(chuàng)建服務(wù)的程序片段,其中我們只是創(chuàng)建服務(wù)并未設(shè)置服務(wù)描述信息,啟動(dòng)服務(wù)的操作。下面的程序片段給出了示例:
bool RegterService(char* pszServiceName,
char* pszDisplayName,
char* pszServicePath,
char* pszDescription)
{
SC_HANDLE newService,scm;
BOOL success = FALSE;
SERVICE_STATUS status;
SERVICE_DESCRIPTION description;
if (pszDisplayName==NULL&&pszServiceName==NULL&&pszServicePath==NULL)
{
return false;
}
description.lpDescription=pszDescription;
scm = OpenSCManager(NULL,NULL,SC_MANAGER_ENUMERATE_SERVICE|SC_MANAGER_CREATE_SERVICE);
if (!scm){
OUT_DEBUG("OpenSCManager ERROR!");
return false;
}
newService = CreateService(scm,pszServiceName,pszDisplayName,
SERVICE_ALL_ACCESS|SERVICE_STOP,SERVICE_WIN32_OWN_PROCESS,
SERVICE_AUTO_START,SERVICE_ERROR_NORMAL,pszServicePath,
0,0,0,0,0);
if (!newService){
OUT_DEBUG("CreateService ERROR!");
CloseServiceHandle(scm);
return false;
}
if (description.lpDescription!=NULL)
{
success=ChangeServiceConfig2(newService,
SERVICE_CONFIG_DESCRIPTION,
&description);
}
success = QueryServiceStatus(newService,&status);
if (!success){
cout<<"QueryServiceStatus ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(newService);
CloseServiceHandle(scm);
return false;
}
if (status.dwCurrentState!=SERVICE_RUNNING)
{
success = StartService(newService,NULL,NULL);
if (!success){
cout<<"ControlService ERROR:"<<GetLastError()<<endl;
CloseServiceHandle(newService);
CloseServiceHandle(scm);
return false;
}
}
CloseServiceHandle(newService);
CloseServiceHandle(scm);
return true;
}
ChangeServiceConfig函數(shù)可以配置更多關(guān)于服務(wù)的信息,下面列出其原型:
BOOL ChangeServiceConfig(
SC_HANDLE
hService
//
打開服務(wù)時(shí)返回的句柄
DWORD
dwServiceType
,
//
服務(wù)的類型
DWORD
dwStartType
,
//
何時(shí)啟動(dòng)服務(wù)
DWORD
dwErrorControl
,
//
錯(cuò)誤控制代碼
LPCTSTR
lpBinaryPathName
,
//
服務(wù)的路徑
LPCTSTR
lpLoadOrderGroup
,
//
服務(wù)所屬的組
LPDWORD
lpdwTagId
,
//
服務(wù)的標(biāo)記
LPCTSTR
lpDependencies
,
//
依賴的其它服務(wù)和組
LPCTSTR
lpServiceStartName
,
//
服務(wù)的啟動(dòng)用戶
LPCTSTR
lpPassword
,
//
服務(wù)啟動(dòng)用戶的密碼
LPCTSTR
lpDisplayName
//
服務(wù)的顯示名
);
大家可以看到ChangeServiceConfig
與CreateServiceee 有著相似
的參數(shù),它們的使用方法也十分相似可以參照CreateServiceee
函數(shù)調(diào)用
。它主要在服務(wù)安裝完成后,需要對(duì)服務(wù)的配置進(jìn)行修改時(shí)調(diào)用,除了lpDisplayName改變時(shí)需要服務(wù)停止才能生效外,其它都可以運(yùn)行時(shí)動(dòng)態(tài)改變;更詳細(xì)信息可查閱MSDN。
4.4
控制服務(wù)
有時(shí)我們要根據(jù)實(shí)際情況啟動(dòng)、暫停、停止一個(gè)服務(wù)。在4.3中的程序示例里面就一個(gè)啟動(dòng)服務(wù)的調(diào)用。這里我們?cè)俸唵谓榻B一下這個(gè)函數(shù):
BOOL StartService(
SC_HANDLE
hService
,
//
打開服務(wù)時(shí)返回的句柄
DWORD
dwNumServiceArgs
,
//
服務(wù)程序參數(shù)的個(gè)數(shù)
LPCTSTR
*lpServiceArgVectors
//
存放服務(wù)程序參數(shù)的數(shù)組
);
當(dāng)服務(wù)程序需要配置啟動(dòng)參數(shù)時(shí)就需要使用StartService
后面的兩個(gè)參數(shù),服務(wù)程序的入口函數(shù)也就可以接到相關(guān)的參數(shù)了
。函數(shù)調(diào)用成功時(shí)返回非零,當(dāng)返回零時(shí)調(diào)用失敗;更詳細(xì)的出錯(cuò)信息可以調(diào)用GetLastError
獲得。
啟動(dòng)后如果我們還要控制其暫停、繼續(xù)、停止的話,還需要另一個(gè)函數(shù)調(diào)用來完成。在上面刪除服務(wù)的例示程序片段中我們調(diào)用了
ControlService函數(shù)來停止服務(wù),下面我們介紹一下它的詳細(xì)信息:
BOOL ControlService(
SC_HANDLE
hService
,
//
打開服務(wù)時(shí)返回的句柄
DWORD
dwControl
,
//
控制代碼
LPSERVICE_STATUS
lpServiceStatus
//
服務(wù)的狀態(tài)
);
調(diào)用此函數(shù)會(huì)把控制代碼發(fā)給指定服務(wù)程序的Handler處理函數(shù)同時(shí)返回服務(wù)的狀態(tài),服務(wù)程序得到相應(yīng)的控制代碼后根據(jù)協(xié)議要執(zhí)行相應(yīng)的操作;控制代碼就是Handler規(guī)定響應(yīng)的所有代碼。我們不能啟動(dòng)和停止服務(wù)安全描述符不允許的服務(wù)程序。默認(rèn)的安全描述符只允許
LocalSystem、 Administrators和 Power Users來啟動(dòng)和停止服務(wù)程序。服務(wù)的安全描述符來用SetServiceObjectSecurity來設(shè)置(更詳細(xì)信息的信息可查閱MSDN)。
5 結(jié)束語