本文主要介紹了 OpenSCManager、CreateService、OpenService、ControlService、DeleteService、RegisterServiceCtrlHandler、SetServiceStatus、StartServiceCtrlDispatcher等操作服務程序的主要幾個API的用法,具體的函數參數大家可以查閱MSDN。
為什麼要使用服務應該程序呢?服務程序就像系統的一些服務一樣,能夠自動地啟動,並執行相應的操作;而且因為服務程序的在層次上和一般的應用程序不同,其能夠在系統啟動時就自動地運行,而不像一般的應用程序那樣一定要在登陸後才能運行,這些就是服務的一些好處了,如果你也想你的程序具有這樣的功能,那麼你就可以建立一個服務應用程序了。下面就跟著我一步一步地教你怎麼去創建一個服務應用程序吧。
一、建立 Win32 Application 應用程序(當然你也可以建立其它的應用程序,但服務一般是沒有用戶界面的),並命名為 ServiceTest。
二、定義全局函數變量。這裡主要是設置服務句柄和狀態。
BOOL IsInstalled();
三、添加Init初始化函數。
BOOL Install();
BOOL Uninstall();
void LogEvent(LPCTSTR pszFormat, ...);
void WINAPI ServiceMain();
void WINAPI ServiceStrl(DWORD dwOpcode);
TCHAR szServiceName[] = _T("ServiceTest");
BOOL bInstall;
SERVICE_STATUS_HANDLE hServiceStatus;
SERVICE_STATUS status;
DWORD dwThreadID;void Init()
{
hServiceStatus = NULL;
status.dwServiceType = SERVICE_WIN32_OWN_PROCESS;
status.dwCurrentState = SERVICE_STOPPED;
tatus.dwControlsAccepted = SERVICE_ACCEPT_STOP;
status.dwWin32ExitCode = 0;
status.dwServiceSpecificExitCode = 0;
status.dwCheckPoint = 0;
status.dwWaitHint = 0;
}
四、添加安裝和刪除服務函數。這裡主要是用到了四個函數 OpenSCManager 和 CreateService。OpenSCManager 用於打開服務控制管理器;CreateService 用於創建服務;OpenService用於打開已有的服務,返回該服務的句柄;ControlService則用於控制已打開的服務狀態,這裡是讓服務停止後才刪除;DeleteService 用於刪除指定服務。BOOL Install();
{
//這裡列出主要的兩個函數,其它的可以在代碼裡找。
//打開服務控制管理器
OpenSCManager(NULL, NULL, SC_MANAGER_ALL_ACCESS);
//創建服務
SC_HANDLE hService = ::CreateService(
hSCM, szServiceName, szServiceName,
SERVICE_ALL_ACCESS, SERVICE_WIN32_OWN_PROCESS,
SERVICE_DEMAND_START, SERVICE_ERROR_NORMAL,
szFilePath, NULL, NULL, _T(""), NULL, NULL);
::CloseServiceHandle(hService);
::CloseServiceHandle(hSCM);
}
BOOL Uninstall();
{
//這裡列出主要的兩個函數,其它的可以在代碼裡找。
//打開服務控制管理器
OpenSCManager(NULL, NULL, SC_MANAGER_ALL_ACCESS);
//打開服務
OpenService(hSCM, szServiceName, SERVICE_STOP | DELETE);
//停止服務
ControlService(hService, SERVICE_CONTROL_STOP, &status);
//刪除服務
DeleteService(hService);
…
}
五、添加服務主線程函數和控制函數。這裡調用 RegisterServiceCtrlHandler 來注冊服務的控制函數,這裡要設置status.dwControlsAccepted 為 SERVICE_ACCEPT_STOP,否則你不能控制這個服務的狀態。
void WINAPI ServiceMain()
{
// Register the control request handler
status.dwCurrentState = SERVICE_START_PENDING;
status.dwControlsAccepted = SERVICE_ACCEPT_STOP;//這個要使用,否則你不能控制
//注冊服務控制
hServiceStatus = RegisterServiceCtrlHandler(szServiceName, ServiceStrl);
if (hServiceStatus == NULL)
{
LogEvent(_T("Handler not installed"));
return;
}
SetServiceStatus(hServiceStatus, &status);
status.dwWin32ExitCode = S_OK;
status.dwCheckPoint = 0;
status.dwWaitHint = 0;
status.dwCurrentState = SERVICE_RUNNING;
SetServiceStatus(hServiceStatus, &status);
//模擬服務的運行,10後自動退出。應用時將主要任務放於此即可
int i = 0;
while (i < 10)
{
Sleep(1000);
i++;
}
//
status.dwCurrentState = SERVICE_STOPPED;
SetServiceStatus(hServiceStatus, &status);
LogEvent(_T("Service stopped"));
}
六、在主線程函數裡注冊控制函數和程序執行主體。這裡主要是說明這就是程序的執行體。void WINAPI ServiceMain()
{
…
//模擬服務的運行,10後自動退出。應用時將主要任務放於此即可
int i = 0;
while (i < 10)
{
Sleep(1000);
i++;
}
…
}
七、最後,要在main函數裡注冊添加安裝、刪除、注冊主函數。int APIENTRY WinMain(HINSTANCE hInstance,
HINSTANCE hPrevInstance,
LPSTR lpCmdLine,
int nCmdShow)
{
Init();
dwThreadID = ::GetCurrentThreadId();
SERVICE_TABLE_ENTRY st[] =
{
{ szServiceName, (LPSERVICE_MAIN_FUNCTION)ServiceMain },
{ NULL, NULL }
};
if (stricmp(lpCmdLine, "/install") == 0)
{
Install();
}
else if (stricmp(lpCmdLine, "/uninstall") == 0)
{
Uninstall();
}
else
{
if (!::StartServiceCtrlDispatcher(st))
{
LogEvent(_T("Register Service Main Function Error!"));
}
}
return 0;
}
八、總結。其實做一個服務程序並不難,主要是懂得程序的執行體放於哪裡?和注冊程序的主函數和注冊控制函數,如果這兩個沒有注冊的話,你就程序就不知道如何去控制了。status.dwControlsAccepted = SERVICE_ACCEPT_STOP;這個也重要,如果你沒有設置的話,那麼服務就不會受你控制了.
本文配套源碼