C編寫Windows服務程序的五個步驟

Windows 服務被設計用于需要在後台運行的應用程序以及實現沒有用戶交互的任務。爲了學習這種控制台應用程序的基礎知識,C(不是C++)是最佳選擇。本文將建立並實現一個簡單的服務程序,其功能是查詢系統中可用物理內存數量,然後將結果寫入一個文本文件。

最後,你可以用所學知識編寫自己的 Windows 服務。

當初我寫第一個NT 服務時,我到 MSDN 上找例子。在那裏我找到了一篇 Nigel Thompson 寫的文章:“Creating a Simple Win32 Service in C++”,這篇文章附帶一個 C++ 例子。雖然這篇文章很好地解釋了服務的開發過程,但是,我仍然感覺缺少我需要的重要信息。我想理解通過什麽框架,調用什麽函數,以及何時調用,但 C++ 在這方面沒有讓我輕松多少。面向對象的方法固然方便,但由于用類對底層 Win32 函數調用進行了封裝,它不利于學習服務程序的基本知識。這就是爲什麽我覺得 C 更加適合于編寫初級服務程序或者實現簡單後台任務的服務。在你對服務程序有了充分透徹的理解之後,用 C++ 編寫才能遊刃有余。當我離開原來的工作崗位,不得不向另一個人轉移我的知識的時候,利用我用 C 所寫的例子就非常輕易解釋 NT 服務之所以然。

服務是一個運行在後台並實現勿需用戶交互的任務的控制台程序。Windows NT/2000/XP 操作系統提供爲服務程序提供專門的支持。人們可以用服務控制面板來配置安裝好的服務程序,也就是 windows 2000/XP 控制面板治理工具中的“服務”(或在“開始”“運行”對話框中輸入 services.msc /s——譯者注)。可以將服務配置成操作系統啓動時自動啓動,這樣你就不必每次再重啓系統後還要手動啓動服務。

本文將首先解釋如何創建一個定期查詢可用物理內存並將結果寫入某個文本文件的服務。然後指導你完成生成,安裝和實現服務的整個過程。

第一步:主函數和全局定義

首先,包含所需的頭文件。例子要調用 Win32 函數(windows.h)和磁盤文件寫入(stdio.h):

#include

#include

接著,定義兩個常量:

#define SLEEP_TIME 5000

#define LOGFILE "C:\\MyServices\\memstatus.txt"

SLEEP_TIME 指定兩次連續查詢可用內存之間的毫秒間隔。在第二步中編寫服務工作循環的時候要使用該常量。

LOGFILE 定義日志文件的路徑,你將會用 WriteToLog 函數將內存查詢的結果輸出到該文件,WriteToLog 函數定義如下:

int WriteToLog(char* str)

{

FILE* log;

log = fopen(LOGFILE, "a+");

if (log == NULL)

return -1;

fPRintf(log, "%s\n", str);

fclose(log);

return 0;

}

聲明幾個全局變量,以便在程序的多個函數之間共享它們值。此外,做一個函數的前向定義:

SERVICE_STATUS ServiceStatus;

SERVICE_STATUS_HANDLE hStatus;

void ServiceMain(int argc, char** argv);

void ControlHandler(DWord request);

int InitService();

現在,預備工作已經就緒,你可以開始編碼了。服務程序控制台程序的一個子集。因此,開始你可以定義一個 main 函數,它是程序的入口點。對于服務程序來說,main 的代碼令人驚奇地簡短,因爲它只創建分派表並啓動控制分派機。

void main()

{

SERVICE_TABLE_ENTRY ServiceTable[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:Services Control Manager)是一個治理系統所有服務的進程。當 SCM 啓動某個服務時,它等待某個進程的主線程來調用 StartServiceCtrlDispatcher 函數。將分派表傳遞給 StartServiceCtrlDispatcher。這將把調用進程的主線程轉換爲控制分派器。該分派器啓動一個新線程,該線程運行分派表中每個服務的 ServiceMain 函數(本文例子中只有一個服務)分派器還監視程序中所有服務的執行情況。然後分派器將控制請求從 SCM 傳給服務。

注重:假如 StartServiceCtrlDispatcher 函數30秒沒有被調用,便會報錯,爲了避免這種情況,我們必須在 ServiceMain 函數中(參見本文例子)或在非主函數的單獨線程中初始化服務分派表。本文所描述的服務不需要防範這樣的情況。

分派表中所有的服務執行完之後(例如,用戶通過“服務”控制面板程序停止它們),或者發生錯誤時。StartServiceCtrlDispatcher 調用返回。然後主進程終止。

推薦文章:搞笑之可愛水果表情清新素潔水仙壁紙集

C編寫Windows服務程序的五個步驟
更多內容請看Windows操作系統安全集 Windows操作系統安裝 Windows頻道專題,或 第二步:ServiceMain 函數

Listing 1 展示了 ServiceMain 的代碼。該函數是服務的入口點。它運行在一個單獨的線程當中,這個線程是由控制分派器創建的。ServiceMain 應該盡可能早早爲服務注冊控制處理器。這要通過調用 RegisterServiceCtrlHadler 函數來實現。

你要將兩個參數傳遞給此函數:服務名和指向 ControlHandlerfunction 的指針。

它指示控制分派器調用 ControlHandler 函數處理 SCM 控制請求。注冊完控制處理器之後,獲得狀態句柄(hStatus)。通過調用 SetServiceStatus 函數,用 hStatus 向 SCM 報告服務的狀態。

Listing 1 展示了如何指定服務特征和其當前狀態來初始化 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 函數來完成初始化。這個函數只是添加一個說明性字符串到日志文件。如下面代碼所示:

// 服務初始化

int InitService()

{

int result;

result = WriteToLog("Monitoring started.");

return(result);

}

在 ServiceMain 中,檢查 InitService 函數的返回值。假如初始化有錯(因爲有可能寫日志文件失敗),則將服務狀態置爲終止並退出 ServiceMain:

error = InitService();

if (error)

{

// 初始化失敗,終止服務

ServiceStatus.dwCurrentState = SERVICE_STOPPED;

ServiceStatus.dwWin32ExitCode = -1;

SetServiceStatus(hStatus, &ServiceStatus);

// 退出 ServiceMain

return;

}

假如初始化成功,則向 SCM 報告狀態:

// 向 SCM 報告運行狀態

ServiceStatus.dwCurrentState = SERVICE_RUNNING;

SetServiceStatus (hStatus, &ServiceStatus);

接著,啓動工作循環。每五秒鍾查詢一個可用物理內存並將結果寫入日志文件。

如 Listing 1 所示,循環一直到服務的狀態爲 SERVICE_RUNNING 或日志文件寫入出錯爲止。狀態可能在 ControlHandler 函數響應 SCM 控制請求時修改。

推薦文章:搞笑之可愛水果表情清新素潔水仙壁紙集

C編寫Windows服務程序的五個步驟
更多內容請看Windows操作系統安全集 Windows操作系統安裝 Windows頻道專題,或 第三步:處理控制請求

在第二步中,你用 ServiceMain 函數注冊了控制處理器函數。控制處理器與處理各種 Windows 消息的窗口回調函數非常類似。它檢查 SCM 發送了什麽請求並采取相應行動。

每次你調用 SetServiceStatus 函數的時候,必須指定服務接收 STOP 和 SHUTDOWN 請求。Listing 2 示範了如何在 ControlHandler 函數中處理它們。

STOP 請求是 SCM 終止服務的時候發送的。例如,假如用戶在“服務”控制面板中手動終止服務。SHUTDOWN 請求是關閉機器時,由 SCM 發送給所有運行中服務的請求。兩種情況的處理方式相同:

寫日志文件,監視停止;

向 SCM 報告 SERVICE_STOPPED 狀態;

由于 ServiceStatus 結構對于整個程序而言爲全局量,ServiceStatus 中的工作循環在當前狀態改變或服務終止後停止。其它的控制請求如:PAUSE 和 CONTINUE 在本文的例子沒有處理。

控制處理器函數必須報告服務狀態,即便 SCM 每次發送控制請求的時候狀態保持相同。因此,不管響應什麽請求,都要調用 SetServiceStatus。

C編寫Windows服務程序的五個步驟

第四步:安裝和配置服務

程序編好了,將之編譯成 exe 文件。本文例子創建的文件叫 MemoryStatus.exe,將它拷貝到 C:\MyServices 文件夾。爲了在機器上安裝這個服務,需要用 SC.EXE 可執行文件,它是 Win32 Platform SDK 中附帶的一個工具。(譯者注:Visaul Studio .NET 2003 IDE 環境中也有這個工具,具體存放位置在:C:\Program Files\Microsoft Visual Studio .NET 2003\Common7\Tools\Bin\winnt)。使用這個實用工具可以安裝和移除服務。其它控制操作將通過服務控制面板來完成。以下是用命令行安裝 MemoryStatus 服務的方法:

sc create MemoryStatus binpath= c:\MyServices\MemoryStatus.exe

發出此創建命令。指定服務名和二進制文件的路徑(注重 binpath= 和路徑之間的那個空格)。安裝成功後,便可以用服務控制面板來控制這個服務(參見圖一)。用控制面板的工具欄啓動和終止這個服務。

推薦文章:搞笑之可愛水果表情清新素潔水仙壁紙集

C編寫Windows服務程序的五個步驟
更多內容請看Windows操作系統安全集 Windows操作系統安裝 Windows頻道專題,或

C編寫Windows服務程序的五個步驟

MemoryStatus 的啓動類型是手動,也就是說根據需要來啓動這個服務。右鍵單擊該服務,然後選擇上下文菜單中的“屬性”菜單項,此時顯示該服務的屬性窗口。在這裏可以修改啓動類型以及其它設置。你還可以從“常規”標簽中啓動/停止服務。以下是從系統中移除服務的方法:

sc delete MemoryStatus

指定 “delete” 選項和服務名。此服務將被標記爲刪除,下次西通重啓後,該服務將被完全移除。

第五步:測試服務

從服務控制面板啓動 MemoryStatus 服務。假如初始化不出錯,表示啓動成功。過一會兒將服務停止。檢查一下 C:\MyServices 文件夾中 memstatus.txt 文件的服務輸出。在我的機器上輸出是這樣的:

Monitoring started.

273469440

273379328

273133568

273084416

Monitoring stopped.

爲了測試 MemoryStatus 服務在出錯情況下的行爲,可以將 memstatus.txt 文件設置成只讀。

這樣一來,服務應該無法啓動。

去掉只讀屬性,啓動服務,在將文件設成只讀。服務將停止執行,因爲此時日志文件寫入失敗。假如你更新服務控制面板的內容,會發現服務狀態是已經停止。

開發更大更好的服務程序

理解 Win32 服務的基本概念,使你能更好地用 C++ 來設計包裝類。包裝類隱藏了對底層 Win32 函數的調用並提供了一種舒適的通用接口。修改 MemoryStatus 程序代碼,創建滿足自己需要的服務!爲了實現比本文例子所示範的更複雜的任務,你可以創建多線程的服務,將作業劃分成幾個工作者線程並從 ServiceMain 函數中監視它們的執行。

C編寫Windows服務程序的五個步驟
更多內容請看Windows操作系統安全集 Windows操作系統安裝 Windows頻道專題,或

用C語言編寫Windows服務程序的五個步驟
前一段時間我寫了一篇通過寫服務的形式來達到一些監視程序運行的目的的文章,至于如何在windows下寫服務我沒有具體介紹,今天就讓我們一起看看如何來寫服務程序。 Windows 服務被設計用于需要在後台運行的應用程...查看完整版>>用C語言編寫Windows服務程序的五個步驟
 
用 C 語言編寫 Windows 服務程序的五個步驟
前一段時間我寫了一篇通過寫服務的形式來達到一些監視程序運行的目的的文章,至于如何在windows下寫服務我沒有詳細介紹,今天就讓我們一起看看如何來寫服務程序。 Windows 服務被設計用于需要在後台運行的應用程...查看完整版>>用 C 語言編寫 Windows 服務程序的五個步驟
 
C編寫Windows服務程序的五個步驟
Windows 服務被設計用于需要在後台運行的應用程序以及實現沒有用戶交互的任務。爲了學習這種控制台應用程序的基礎知識,C(不是C++)是最佳選擇。本文將建立並實現一個簡單的服務程序,其功能是查詢系統中可用物理內...查看完整版>>C編寫Windows服務程序的五個步驟
 
怎樣用C語言編寫一個DOS下的中斷服務程序
  回複1: TC本身提供中斷程序的接口,函數名記不清了,大概的過程是定義一個函數作爲中斷的處理程序,然後調用TC自己的函數(可以在DOS.H或BIOS.H中找到,名稱與Inter...查看完整版>>怎樣用C語言編寫一個DOS下的中斷服務程序
 
如何用PERL編寫聊天室服務器程序
  在這裏我將告訴你如何來寫一個小型的聊天室服務程序,可能會很簡陋,有很多要擴展的地方.  先決條件:  你必須有很好的Perl編程的知識,一台服務器,安裝Perl 5.002或更高的版本.注意大多數ISP不會允許普通用戶運...查看完整版>>如何用PERL編寫聊天室服務器程序
 
用Delphi編寫Win2000服務程序
用Delphi編寫Win2000服務程序 摘要:本文介紹用Delphi編寫Win2000服務程序,所涉及到的類是TServiceApplicatoin,TService,TServiceThread等。 關鍵字: Service/服務 一、Win2000服務簡介服務程序(Service Appli...查看完整版>>用Delphi編寫Win2000服務程序
 
利用C++編寫Windows服務程序的一般框架
下面是我寫的一個Service程序框架,實現了如下功能: 1。Service監視窗口的創建。 2。Service中消息處理的實現 3。C++ 類的使用。 4。工作線程函數的使用。 ****如果需要完成特定的工作,只需將線程函數具體化和實例...查看完整版>>利用C++編寫Windows服務程序的一般框架
 
WSDL編寫的五個步驟
WSDL編寫的五個步驟 我們以http://blog.csdn.net/hongbo781202/archive/2004/07/21/47135.aspx中的案例來說明. 1)聲明名稱空間必須在 <definitions> 元素中提供各種名稱空間的聲明.<definitions targ...查看完整版>>WSDL編寫的五個步驟
 
WSDL編寫的五個步驟
WSDL編寫的五個步驟 我們以中的案例來說明. 1)聲明名稱空間必須在 <definitions> 元素中提供各種名稱空間的聲明.<definitions targetNamespace="" xmlns="" xmlns:xsd="" xmlns:p...查看完整版>>WSDL編寫的五個步驟
 
 
回到王朝網路移動版首頁