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

2021-02-15 C語言三人行+

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 調用返回。然後主進程終止。


第二步: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 控制請求時修改。


第三步:處理控制請求

  在第二步中,你用 ServiceMain 函數註冊了控制處理器函數。控制處理器與處理各種 Windows 消息的窗口回調函數非常類似。它檢查 SCM 發送了什麼請求並採取相應行動。
  每次你調用 SetServiceStatus 函數的時候,必須指定服務接收 STOP 和 SHUTDOWN 請求。Listing 2 示範了如何在 ControlHandler 函數中處理它們。
  STOP 請求是 SCM 終止服務的時候發送的。例如,如果用戶在「服務」控制面板中手動終止服務。SHUTDOWN 請求是關閉機器時,由 SCM 發送給所有運行中服務的請求。兩種情況的處理方式相同:

寫日誌文件,監視停止;
向 SCM 報告 SERVICE_STOPPED 狀態;
  由於 ServiceStatus 結構對於整個程序而言為全局量,ServiceStatus 中的工作循環在當前狀態改變或服務終止後停止。其它的控制請求如:PAUSE 和 CONTINUE 在本文的例子沒有處理。
  控制處理器函數必須報告服務狀態,即便 SCM 每次發送控制請求的時候狀態保持相同。因此,不管響應什麼請求,都要調用 SetServiceStatus。

第四步:安裝和配置服務

  程序編好了,將之編譯成 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= 和路徑之間的那個空格)。安裝成功後,便可以用服務控制面板來控制這個服務。用控制面板的工具欄啟動和終止這個服務。

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

sc delete MemoryStatus
指定 「delete」 選項和服務名。此服務將被標記為刪除,下次西通重啟後,該服務將被完全移除。
第五步:測試服務

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

Monitoring started.
273469440
273379328
273133568
273084416
Monitoring stopped.
  為了測試 MemoryStatus 服務在出錯情況下的行為,可以將 memstatus.txt 文件設置成只讀。這樣一來,服務應該無法啟動。
  去掉只讀屬性,啟動服務,在將文件設成只讀。服務將停止執行,因為此時日誌文件寫入失敗。如果你更新服務控制面板的內容,會發現服務狀態是已經停止。

相關焦點

  • 用Python使用C語言程序(Windows平臺)
    qianyan在機器學習中,很多時候我們需要Python和C的混合編程,最重要的原因是為了性能效率的提升: 解釋型語言一般比編譯型語言慢,一般提高性能的有效做法是,先做性能測試,找出性能瓶頸部分,然後把瓶頸部分在擴展中實現。本文的目標是在windows平臺下(使用pycharm),實現python調用C語言編寫的程序。
  • C語言編寫Windows下的實用程序:[1]對話框
    相信很多C語言初學者,都會有一種困惑,C語言的教程、教材上面很多是對C語言的語法和算法講解,而沒有教大家做一些真正可以用到的程序,從而質疑C語言到底是否足夠牛X,能夠開發出炫麗多彩的遊戲嗎;對C語言的可用性、易用性、強大產生懷疑。
  • 編寫C程序的7個步驟
    很多人覺得編寫一個C語言程序是個很複雜的問題,但其實是很簡單的,至少對於二級C考試題目來說都比較簡單。面對一個相對複雜的問題,我們要學會理清楚思路,把它分解成若干小問題,然後條理清晰地解決這個「複雜」的問題。
  • C語言編寫程序求水仙花數
    C語言編寫程序求水仙花數水仙花數是一個數學問題,其實質是一個三位數,個位數的立方加十位數的立方加百位數的立方之和等於這個三位數本身。例如153=1*1*1+5*5*5+3*3*3,即153=1+125+27。
  • 【C語言】02.第一個C語言程序
    三、連結程序四、運行程序五、總結六、學習建議七、clang指令匯總前言前面已經嘮叨了這麼多理論知識,從這講開始,就要通過接觸代碼來學習C語言的語法。學習任何一門語言,首先要掌握的肯定是語法。學習C語言語法的目的:就是能夠利用C語言編寫程序,然後運行程序跟硬體(計算機、手機等硬體設備)進行交互。由於我們的最終目的是學習iOS開發,學習iOS開發的話必須在Mac系統下,因此我就在Mac系統環境下開發C語言程序,而不是在Windows環境下。
  • 用C語言編寫程序列印輸出九九乘法表
    用C語言編寫程序列印輸出九九乘法表C語言的功能十分強大,本人非常喜歡,九九乘法表既有C程序中的循環結構,也有輸出格式的設置,能夠體現出C程序的風格特點。下面就C程序編寫九九表分享給大家!int main()//定義整型主函數{int a,b,c;//定義整型變量a,b。for(a=1;a<=9;a++)//外層循環,從1到9,指的列印輸出9行。
  • 加速程序開發 Python整合C語言模塊
    而作為軟體開發的傳統程式語言——C語言,卻能在這些問題上很好地彌補Python語言的不足。因此,本文通過實例研究如何在Python程序中整合既有的C語言模塊,包括用C語言編寫的源程序和動態連結庫等,從而充分發揮Python語言和C語言各自的優勢。Python語言的特點Python作為一門程序開發語言,被越來越多地運用到快速程序開發。
  • 《零基礎看得懂的C語言入門教程 》——(十三)socket服務端編寫
    一、學習目標目錄第一篇:(一)脫離學習誤區第二篇:(二)C語言沒那麼難簡單開發帶你了解流程第三篇:(三)輕輕鬆鬆理解第一個C語言程序第四篇:(四)語言的基本數據類型及變量第五篇:(五)C語言的變量、常量及運算第六篇:(六)輕輕鬆鬆了解C語言的邏輯運算第七篇:(七)C語言的循環分分鐘上手第八篇:(八)了解基本數組還不是那麼簡單
  • C語言,編寫程序將兩一維數組合併並排序
    編寫一個程序,將兩個元素從小到大有序的一維數組歸併成一個有序的一維數組。 要求:【輸入形式】用戶在第一行輸入第一個有序數組的元素數目,以回車結束此輸入。然後在第二行按照剛才輸入的元素數目依次輸入數組元素,中間用空格分隔,最後用回車結束輸入。
  • Code::Blocks使用教程(使用Code::Blocks編寫C語言程序)
    CodeBlocks 完全支持單個源文件的編譯,如果你的程序只有一個源文件(初學者基本上都是在單個源文件下編寫代碼),那麼不用創建項目,直接運行即可;如果有多個源文件,才需要創建項目。注意:保存時,將源文件後綴名改為 .c。2) 生成可執行程序在上方菜單欄中選擇 構建 --> 構建,就可以完成 hello.c 的編譯工作。
  • 用C語言程序比大小及C語言程序的結構
    今天讓我們學習用C語言編寫比較兩個數大小的程序例:求兩個整數中的較大者
  • c語言五個經典程序
    #13; c語言五個經典程序
  • 在Stata中編寫估計命令:編寫C語言插件
    這篇文章演示了如何用其他語言(如C,C 或Java)編寫的代碼插入到Stata中。這種技術被稱為Stata編寫插件或編寫動態連結庫(DLL)。本文中,在C語言中編寫一個插件,它實現了mymean11.ado中mymean_work()執行的計算,在文章在Stata中編寫估計命令編寫插件中討論過。
  • C語言入門
    這些都可以用來編寫C語言程序。2、什麼是編譯器通過編輯器寫出的代碼只是源程序的文本文件,必須經過編譯之後才可以在電腦上運行。常用的編譯器有:microsoft C++Compiler、gcc等。3、什麼是集成開發環境(IDE)集成開發環境就是為程序開發提供的環境應用軟體,裡面集成了編輯器和編譯器。
  • c語言入門之安裝code::blocks
    C語言是一門面向過程的、抽象化的通用程序設計語言,廣泛應用於底層開發。
  • 學好C語言的7個步驟,你都了解嗎?
    C語言是如今非常熱門的程式語言,許多人都想學習它,但是,一開始往往無從下手,今天,小編就給大家介紹學好7語言的7個步驟,幫助你明白應該如何學習它。學習C語言之初,遇到的問題都很簡單。但是,隨著要處理的情況越來越複雜,需要決策和考慮的方面也越來越多。通常,選擇一個合適的方式表示信息可以更容易地設計程序和處理數據。三、編寫代碼設計好程序後,就可以著手編寫代碼了。這一步就是把你設計的程序翻譯成C語言。
  • PSIM仿真軟體高級應用——C語言動態連結庫編寫和調用
    C語言知識C語言語法和常用編程流程;子函數的調用和申明;重點掌握C語言中數組、指針、結構體、共用體等應用;養成良好的編程習慣和變量命名習慣。靜態連結庫和動態連結庫(DLL)應用靜態連結庫就是常說的lib文件,用戶可以將常用的C語言子函數封裝成靜態庫文件,以便建立動態DLL文件是直接調用,也有利於代碼的歸檔和保存;動態連結庫文件就是常說的DLL文件,用戶可以將原理圖電路難以實現的功能或者控制算法(比如變流器設備閉環控制算法、電機控制算法等)用C語言編寫
  • C/C++編程筆記:VC++6.0環境下調試 C語言 代碼的方法和步驟
    1.C語言程序四步開發步驟(1)編輯。可以用任何一種編輯軟體將在紙上編寫好的C語言程序輸入計算機,並將C語言源程序文件*.c以純文本文件形式保存在計算機的磁碟上(不能設置字體、字號等)。(2)編譯。編譯過程使用C語言編譯程序將編輯好的源程序文件「*.c」,翻譯成二進位目標代碼文件「*.obj」。編譯程序對源程序逐句檢查語法錯誤發現錯誤後,不僅會顯示錯誤的位置(行號),還會告知錯誤類型信息。
  • 世界上第一個C語言編譯器是怎麼編寫的?它為什麼能夠用C語言編寫?
    不知道大家有沒有想過一個問題:C語言編譯器為什麼能夠用C語言編寫? 今天小編就帶大家一探究竟! 所謂C語言編譯器,就是把編程得到的文件,比如.c,.h的文件,進行讀取,並對內容進行分析,按照C語言的規則
  • C語言簡明教程(七)模塊化程序設計
    >(七)模塊化程序設計實驗簡介我們現在已經能夠編寫很多簡單的 C 語言程序了,但是如果程序的功能比較多的話,規模比較大,把所有的程序代碼都寫在一個主函數--main() 函數中,就會使主函數變得龐雜,閱讀和維護都會很困難。