用 VC++ 2008 编写 Windows Service(系统服务)
用 VC++ 2008 编写 Windows Service(系统服务)
2008-03-30 08:08
现在许多 Windows Service 应用都可以用 c# 很好的完成，不过毕竟是托管代码，性能上不及非托管的 VC。网上能找到的 VC 写系统服务的例子，多数都用的 VC6(ATL3.0)。ATL3.0 写系统服务也很不错，只是封装的不很完善，还需要用户写不少代码。ATL7.0 及后续带的系统服务的模板有了更新，用起来简单多了。本文以 ATL 9.0 为例。
文章只是流水般的写了一下步骤。要再具体一些，恐怕就不是一篇文章能做到的了。市面上讲 COM 的书很多，不妨买来看看。
下面就是用 Visual Studio 2008 中的 VC++ 2008 写系统服务的详细步骤（我用的 VC 是英文版的）：
1. 新建项目。
1-1. 启动 Visual Studio 2008。选择 File -> New -> Project...。
1-2. 在 New Project 对话框中，选择 Visual C++ 中的 ATL Project 模板，写入项目名称：ShowjiSvc，点 OK。
1-3. 在打开的 ATL Project Wizard - ShowjiSvc 中，点 Application Settings，选择 Server type 为 Service(EXE)，点 Finish。
2. 安装、卸载服务。
2-1. 编译项目。
2-2. 打开命令提示符，切换到编译后的目录，执行以下命令安装服务：
ShowjiSvc /Service
2-3. 打开服务管理，能找到一个名为 ShowjiSvc 的服务，启动类型是 Manual。可以启动服务、停止服务。
2-4. 停止服务，然后用以下命令卸载服务：
ShowjiSvc /UnRegServer
3. 修改服务的配置。
3-1. 修改服务名称：
在 Resource View 中打开 String Table，修改 IDS_SERVICENAME 的 Caption 为服务的名称：Showji Mobile Service。
3-2. 修改服务的描述：
打开 ShowjiSvc.cpp 文件，在 CShowjiSvcModule 的声明中增加以下函数声明：
HRESULT RegisterAppId(bool bService);
再增加此函数的定义：
HRESULT CShowjiSvcModule::RegisterAppId(bool bService = false ) throw ()
{
HRESULT hr = S_OK;
BOOL res = __super ::RegisterAppId(bService);
if (bService)
{
if (IsInstalled())
{
SC_HANDLE hSCM = ::OpenSCManagerW(NULL, NULL, SERVICE_CHANGE_CONFIG);
SC_HANDLE hService = NULL;
if (hSCM == NULL)
hr = AtlHresultFromLastError();
else
{
hService = ::OpenService(hSCM, m_szServiceName, SERVICE_CHANGE_CONFIG);
if (hService != NULL)
{
::ChangeServiceConfig(hService, SERVICE_NO_CHANGE,
SERVICE_AUTO_START, // 修改服务为自动启动
NULL, NULL, NULL, NULL, NULL, NULL, NULL,
m_szServiceName); // 通过修改资源IDS_SERVICENAME 修改服务的显示名字
SERVICE_DESCRIPTION Description;
TCHAR szDescription[1024];
ZeroMemory(szDescription, 1024);
ZeroMemory(&Description, sizeof (SERVICE_DESCRIPTION));
lstrcpy(szDescription, _T("www.showji.com 示例服务，by [email protected]" ));
Description.lpDescription = szDescription;
::ChangeServiceConfig2(hService, SERVICE_CONFIG_DESCRIPTION, &Description);
::CloseServiceHandle(hService);
}
else
hr = AtlHresultFromLastError();
::CloseServiceHandle(hSCM);
}
}
}
return hr;
}
3-3. 测试修改后的服务。
重新注册服务，在服务管理器中可以看到服务的新名称和描述，并且启动状态已经修改为 Automatic。
测试成功后，注销服务。
4. 修改服务的进程安全设置。
打开 ShowjiSvc.cpp，在 CShowjiSvcModule 的声明中，找到 InitializeSecurity 函数，修改如下：
HRESULT InitializeSecurity() throw ()
{
return CoInitializeSecurity( NULL, -1, NULL, NULL, RPC_C_AUTHN_LEVEL_NONE,
RPC_C_IMP_LEVEL_IDENTIFY, NULL, EOAC_NONE, NULL );
}
要根据自己的情况，做相关的安全性设置。如果没有什么特殊的安全性要求，就按照上面的格式写就行了。
如果没有设置进程安全性的代码，那么 VC 客户端创建对象的时候，会返回 E_ACCESSDENIED 的错误。
VB 客户端的错误提示如下：
实时错误 '70': 拒绝的权限（Run-time error '70': Permission denied）。
5. 增加服务的初始化和释放操作。
打开 ShowjiSvc.cpp，在 CShowjiSvcModule 的声明中，增加以下声明：
HRESULT PreMessageLoop(int nShowCmd);
HRESULT PostMessageLoop();
增加以上声明的相关定义：
HRESULT CShowjiSvcModule::PreMessageLoop(int nShowCmd) throw ()
{
HRESULT hr = __super ::PreMessageLoop(nShowCmd);
if (SUCCEEDED(hr))
{
// Add any custom code to initialize your service
}
return hr;
}
HRESULT CShowjiSvcModule::PostMessageLoop() throw ()
{
HRESULT hr = __super ::PostMessageLoop();
if (SUCCEEDED(hr))
{
// Add any custom code to uninitialize your service
}
return hr;
}
在相关的描述位置增加自己的代码即可。
6. 为服务增加一个叫做 MyMath 的示例组件。
6-1. 选中 ShowjiSvc 项目，点菜单 Project -> Add Class...，选择 ATL 中的 ATL Simple Object，点 Add。
6-2. 在打开的 ATL Simple Object Wizard - ShowjiSvc 对话框的 Short name 中写入组件名称：MyMath。其它名称会自动填好（当然您也可以修改）。
6-3. 在 Option 中可以看到许多选项。如果您搞不懂这些，就保留默认值吧（建议看一下 COM 的相关书籍）。
6-4. 打开 MyMath.rgs，为组件增加服务程序的 ID(代码中的红色粗体部分)：
HKCR
{
ShowjiSvc.MyMath.1 = s 'MyMath Class'
{
CLSID = s '{37F47E87-7D33-43CD-B591-DA01023F90BC}'
}
ShowjiSvc.MyMath = s 'MyMath Class'
{
CLSID = s '{37F47E87-7D33-43CD-B591-DA01023F90BC}'
CurVer = s 'ShowjiSvc.MyMath.1'
}
NoRemove CLSID
{
ForceRemove {37F47E87-7D33-43CD-B591-DA01023F90BC} = s 'MyMath Class'
{
ProgID = s 'ShowjiSvc.MyMath.1'
VersionIndependentProgID = s 'ShowjiSvc.MyMath'
ForceRemove 'Programmable'
LocalServer32 = s '%MODULE%'
val AppID = s '%APPID%'
'TypeLib' = s '{55E58774-E86F-4482-A521-38AE8C85FD1D}'
}
}
}
AppID 必须设置，否则客户端创建对象的时候会超时并报错误：80080005 server execution failed。
并且，系统日志中会出现一个错误：The server {uuid} did not register with DCOM within the required timeout.
VB 客户端的错误提示如下：
实时错误 '429': ActiveX 部件不能创建对象（Run-time error '429': ActiveX component can't create object）。
7. 为 MyMath 组件增加一个方法。
7-1. 在 Class View 中，右击 IMyMath，选择 Add -> Add Method...。
7-2. 在打开的 Add Method Wizard - ShowjiSvc 对话框中，输入 Method name: Sum；
Parameter type 选择 LONG，Parameter name 写 a，Parameter attributes 选择 in，点一下 Add；
Parameter type 选择 LONG，Parameter name 写 b，Parameter attributes 选择 in，点一下 Add；
Parameter type 选择 LONG*，Parameter name 写 s，Parameter attributes 选择 retval，点一下 Add；
点 Finish 添加这个方法。
7-3. 打开 MyMath.cpp 文件，找到 Sum 方法，修改如下：
STDMETHODIMP CMyMath::Sum(LONG a, LONG b, LONG* s)
{
*s = a + b;
return S_OK;
}
8. 编译、注册、启动服务。
8-1. 编译代码。
8-2. 注册服务，执行以下命令行代码：
ShowjiSvc /Service
8-3. 启动服务，执行以下命令行代码：
net start "Showji Mobile Service"
当然，也可以在服务管理器中启动服务。
相对应的停止服务的命令是：
net stop "Showji Mobile Service"
9. 客户端访问测试（用 VB6 举例）。
9-1. 打开 Visual Basic 6.0。
9-2. 新建“标准 EXE”工程。
9-3. 点菜单：工程 -> 引用...，找到 ShowjiSvc 1.0 Type Library 并勾选，点确定。
9-4. 双击 Form1 窗体，进入代码模式，输入以下代码：
Private Sub Form_Load()
Dim math As ShowjiSvcLib.MyMath
Set math = New ShowjiSvcLib.MyMath
MsgBox math.Sum(10, 19)
Set math = Nothing
End Sub
执行后可以看到，VB 正常初始化了系统服务中的 COM 对象，并调用了其中的方法。
10. 部署。
要将项目部署到其它电脑，需要安装 Microsoft Visual C++ 2008 Redistributable Package，否则会提示错误：系统无法执行指定的程序（The system cannot execute the specified program.）。
Microsoft Visual C++ 2008 Redistributable Package 下载地址：
x86 版：http://www.microsoft.com/downloads/details.aspx?FamilyID=9b2da534-3e03-4391-8a4d-074b9f2bc1bf
x64 版：http://www.microsoft.com/downloads/details.aspx?FamilyID=bd2a6171-e2d6-4230-b809-9a8d7548c1b6
11. 相关代码下载：
http://cid-95d89389d5c6e944.skydrive.live.com/self.aspx/Src/VC2008Svc.zip （22k）
本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/ljz888666555/archive/2009/11/06/4777331.aspx