服务程序是windows上重要的一类程序，它们虽然不与用户进行界面交互，但是它们对于系统有着重要的意义。windows上为了管理服务程序提供了一个特别的程序：服务控制管理程序，系统上关于服务控制管理的API基本上都与这个程序打交道。下面通过对服务程序的操作来说明这些API函数
获取系统服务的信息
在windows系统中有专门用来存储服务信息的数据库，而获取系统服务信息主要是通过在这样的数据库中查找。所用到的函数主要有：
OpenSCManager：打开数据库
SC_HANDLE WINAPI OpenSCManager(
__in LPCTSTR lpMachineName,
__in LPCTSTR lpDatabaseName,
__in DWORD dwDesiredAccess
);
这个函数主要用来连接特定计算机上的服务控制管理器，并打开服务控制管理器的数据库。
函数的参数有：
lpMachineName:主机名称
lpDatabaseName:主机中服务数据库的名称
dwDesiredAccess:以何种权限打开服务程序
前两个参数都可以为NULL，如果第一个参数为NULL，则表示在本机上获取，第二个参数为NULL表示从注册表中获取，第三个参数的主要传入如下值：
SC_MANAGER_ALL_ACCESS (0xF003F) ：默认拥有所有权限
SC_MANAGER_CREATE_SERVICE (0x0002)：具有创建服务的权限
SC_MANAGER_CONNECT (0x0001)：连接的权利
SC_MANAGER_ENUMERATE_SERVICE (0x0004) 枚举里面信息的权限
后面的就不再一一说明了，详细信息请看MSDN的记录。在程序中为了方便一般采用SC_MANAGER_ALL_ACCESS 参数
函数如果调用成功，则会返回一个操作数据库的句柄，以后的关于服务的操作都已这个参数作为第一个参数。
EnumServicesStatus：枚举系统服务
BOOL WINAPI EnumServicesStatus(
__in SC_HANDLE hSCManager,
__in DWORD dwServiceType,
__in DWORD dwServiceState,
__out LPENUM_SERVICE_STATUS lpServices,
__in DWORD cbBufSize,
__out LPDWORD pcbBytesNeeded,
__out LPDWORD lpServicesReturned,
__in_out LPDWORD lpResumeHandle
);
hSCManager：服务数据库句柄
dwServiceType：枚举服务的类型，主要有：SERVICE_DRIVER（驱动类型服务）、SERVICE_WIN32（win32类型的服务）
dwServiceState：表示枚举哪中状态的服务，主要有：SERVICE_ACTIVE（已启动的服务）、SERVICE_INACTIVE（未启动的服务）、SERVICE_STATE_ALL（所有服务）
lpServices：这个参数主要是作为一个缓冲区，用来返回服务信息，类型ENUM_SERVICE_STATUS主要存储的是服务名称、显示名称以及一个SERVICE_STATUS 结构体，该结构体的原型如下：
typedef struct _SERVICE_STATUS{
DWORD dwServiceType; //服务类型
DWORD dwControlsAccepted;//当前状态
DWORD dwServiceSpecificExitCode;
DWORD dwCheckPoint;
DWORD dwWaitHint;
} SERVICE_STATUS, *LPSERVICE_STATUS;cbBufSize：缓冲区的大小
pcbBytesNeeded：实际需要缓冲区的大小
lpServicesReturned：服务的返回值
lpResumeHandle：额外的句柄
每一个ENUM_SERVICE_STATUS结构体保存的是一个服务的信息，但是我们事先并不知道有多少个服务，因此不知道该定义多大的服务信息数组，但是windows考虑到了这一点，当函数调用失败时利用GetLastError返回ERROR_MORE_DATA时表示提供的缓冲区不够，这个时候参数pcbBytesNeeded会返回正确的大小，所以使用这个函数一般会经过两个调用第一次lpServices = NULL, cbBufSize = 0,这个时候函数出错并返回所需要的实际大小，然后根据大小动态分陪一个内存缓冲区或者提供一个数组，并传入实际大小，以获取所有服务的信息。下面提供一个具体的例子：
SC_HANDLE scHandle = OpenSCManager(NULL, NULL, SC_MANAGER_ALL_ACCESS);
if(NULL == scHandle)
{
return FALSE;
}
LPENUM_SERVICE_STATUS pServices = NULL;
DWORD dwByteNeed = 0;
DWORD dwServiceReturn = 0;
LPDWORD lpResumeHandle = NULL;
//第一次调用，将缓冲区设置为NULL并将缓冲区大小设置为0
BOOL bRet = ::EnumServicesStatus(scHandle, SERVICE_WIN32, SERVICE_STATE_ALL, pServices, 0, &dwByteNeed, &dwServiceReturn, lpResumeHandle);
if(!bRet)
{
//如果是因为缓冲区大小不够
if(ERROR_MORE_DATA == GetLastError())
{
//保存缓冲区的真实大小
DWORD dwRealNeed = dwByteNeed;
//多分配一个是为了保存字符串末尾的0
pServices = (LPENUM_SERVICE_STATUS)new char[dwRealNeed + 1];
ASSERT(NULL != pServices);
ZeroMemory(pServices, dwRealNeed + 1);
bRet = ::EnumServicesStatus(scHandle, SERVICE_WIN32, SERVICE_STATE_ALL, pServices, dwRealNeed + 1, &dwByteNeed, &dwServiceReturn, lpResumeHandle);
//通过上述代码可以获取到服务的相关信息
}
}
获取服务的主程序所在路径、启动类型以及依赖项
上述代码只能获取到系统服务的部分信息，比如服务的名称，显示名称，等等至于其他的信息需要调用另外的API函数获取
OpenService获取具体服务的句柄
SC_HANDLE WINAPI OpenService(
__in SC_HANDLE hSCManager, //服务数据库的句柄
__in LPCTSTR lpServiceName,//服务的名称
__in DWORD dwDesiredAccess//以何种权限打开，为了方便一般填入SERVICE_ALL_ACCESS所有权限
);
QueryServiceConfig 查询系统服务信息
BOOL WINAPI QueryServiceConfig(
__in SC_HANDLE hService,
__out LPQUERY_SERVICE_CONFIG lpServiceConfig,
__in DWORD cbBufSize,
__out LPDWORD pcbBytesNeeded
);
这个函数的第二个参数是一个结构体指针这个结构体的定义如下：
typedef struct _QUERY_SERVICE_CONFIG {
DWORD dwServiceType; //服务类型
DWORD dwStartType; //启动类型
DWORD dwErrorControl;//错误码，服务执行出错时返回，操作系统根据这个错误码来做相应的处理
LPTSTR lpBinaryPathName;//主程序所在路径
LPTSTR lpLoadOrderGroup;
DWORD dwTagId;
LPTSTR lpDependencies; //依赖项
LPTSTR lpServiceStartName;
LPTSTR lpDisplayName; //显示名称
} QUERY_SERVICE_CONFIG, *LPQUERY_SERVICE_CONFIG;这个函数的调用方式与EnumServicesStatus相同，也是通过两次调用，第一次获得所需的空间大小，这个大小通过第四个参数返回。
下面的代码展示了如何调用这两个函数
//第一个参数是通过OpenSCManager函数获取得到的
SC_HANDLE h_SCService = OpenService(h_SCHandle, pSrvItem->strSrvName, SERVICE_ALL_ACCESS);
if(NULL == h_SCService)
{
CloseServiceHandle(h_SCHandle);
return FALSE;
}
LPQUERY_SERVICE_CONFIG pSrvConfig = NULL;
DWORD dwBuffSize = 0;
DWORD dwBuffNeed = 0;
BOOL bRet = QueryServiceConfig(h_SCService, pSrvConfig, dwBuffSize, &dwBuffNeed);
if(!bRet)
{
if(ERROR_INSUFFICIENT_BUFFER == GetLastError())
{
DWORD dwRealNeed = dwBuffNeed;
pSrvConfig = (LPQUERY_SERVICE_CONFIG)new char[dwRealNeed + 1];
ASSERT(NULL != pSrvConfig);
bRet = QueryServiceConfig(h_SCService, pSrvConfig, dwRealNeed, &dwBuffNeed);
}
}
获取服务的描述信息
描述信息一般是有服务开发人员提供，以便解释服务程序的作用等等信息，这些信息在注入服务时由系统记录，并呈现给用户。获取系统服务主要使用的API函数是QueryServiceConfig2
BOOL WINAPI QueryServiceConfig2(
__in SC_HANDLE hService,
__in DWORD dwInfoLevel,//将获取何种信息在这我们需要填写SERVICE_CONFIG_DESCRIPTION表示获取描述信息
__out LPBYTE lpBuffer,
__in DWORD cbBufSize,
__out LPDWORD pcbBytesNeeded
);
这个函数不想上面的QueryServiceConfig一次可以获取服务的多项信息，它是根据第二个参数指定需要获取哪项信息，然后返回到第3个参数提供的缓冲区中，这个缓冲区是一个BYTE类型的指针，调用者需要根据具体的情况进行类型转化。同样这个函数需要进行两次调用。
BOOL bRet = QueryServiceConfig2(h_SCService, SERVICE_CONFIG_DESCRIPTION, (LPBYTE)lpByte, cbBufSize, &dwBuffNeed);
if(!bRet)
{
if(ERROR_INSUFFICIENT_BUFFER == GetLastError())
{
DWORD dwRealNeed = dwBuffNeed;
//LPSERVICE_DESCRIPTION结构体中只保存了一个字符串指针lpDescription
lpByte = (LPSERVICE_DESCRIPTION)new char[dwRealNeed + 1];
ASSERT(NULL != lpByte);
bRet = QueryServiceConfig2(h_SCService, SERVICE_CONFIG_DESCRIPTION, (LPBYTE)lpByte, dwRealNeed, &dwBuffNeed);
if(!bRet)
{
delete[] lpByte;
goto __ERROR_RET;
}
pSrvItem->strSrvDescrible = lpByte->lpDescription;
delete[] lpByte;
CloseServiceHandle(h_SCService);
CloseServiceHandle(h_SCHandle);
return TRUE;
}
}
__ERROR_RET:
CloseServiceHandle(h_SCService);
CloseServiceHandle(h_SCHandle);
return FALSE;
服务的控制
服务控制主要控制服务的启动，暂停，恢复，停止等等。
StartService启动服务
BOOL WINAPI StartService(
__in SC_HANDLE hService,
__in DWORD dwNumServiceArgs,//启动参数的个数
__in LPCTSTR* lpServiceArgVectors//参数列表指针
);
这个函数有点类似于main函数，main函数可以传递命令行参数给程序，以便实现程序与用户的交互，这里同样可以传递参数，以便服务完成特定的功能，当第二个参数为0时第三个参数为NULL
ControlService 控制服务
BOOL WINAPI ControlService(
__in SC_HANDLE hService,
__in DWORD dwControl,//新状态
__out LPSERVICE_STATUS lpServiceStatus//服务的原始状态
);
这个函数用来完成除了启动之外的服务控制，其中第二个参数是服务的状态，它可使用的参数主要有如下几个：
取值
| 含义
|
SERVICE_CONTROL_CONTINUE
| 继续运行
|
SERVICE_CONTROL_PAUSE
| 暂停
|
SERVICE_CONTROL_STOP
| 停止
|
其余的部分不是很常用，故不在这里一一列举
下面是一个具体的例子，由于要考虑当前的状态以及服务是否支持这种状态，因此这部分的代码多了许多判断的部分
SERVICE_STATUS ServiceStatus = {0};
//获取当前的状态
BOOL bRet = QueryServiceStatus(h_SCService, &ServiceStatus);
ASSERT(bRet);
if(ServiceStatus.dwCurrentState == dwNewStatus)
{
goto __RETURN;
}
//如果当前服务正处在启动和暂停之中，但是没有完成这个动作时不允许改变服务状态
if(ServiceStatus.dwCurrentState == SERVICE_CONTINUE_PENDING || SERVICE_PAUSE_PENDING ==ServiceStatus.dwCurrentState ||
SERVICE_START_PENDING == ServiceStatus.dwCurrentState || SERVICE_STOP_PENDING == ServiceStatus.dwCurrentState)
{
bRet = FALSE;
goto __RETURN;
}
//如果服务处在暂停状态，则只允许继续运行和停止
if(SERVICE_PAUSED == ServiceStatus.dwCurrentState)
{
if(SERVICE_CONTROL_CONTINUE == dwNewStatus || SERVICE_CONTROL_STOP == dwNewStatus)
{
bRet = ControlService(h_SCService, dwNewStatus, &ServiceStatus);
goto __RETURN;
}else
{
bRet = FALSE;
goto __RETURN;
}
}
//如果服务正在运行，则运行暂停和停止
if(SERVICE_RUNNING == ServiceStatus.dwCurrentState)
{
if(SERVICE_CONTROL_PAUSE == dwNewStatus || SERVICE_CONTROL_STOP == dwNewStatus)
{
bRet = ControlService(h_SCService, dwNewStatus, &ServiceStatus);
goto __RETURN;
}else
{
bRet = FALSE;
goto __RETURN;
}
}
//如果服务处于停止状态，则允许运行操作
if(SERVICE_STOPPED == ServiceStatus.dwCurrentState)
{
if(SERVICE_RUNNING == dwNewStatus)
{
bRet = StartService(h_SCService, 0, NULL);
goto __RETURN;
}else
{
bRet = FALSE;
goto __RETURN;
}
}
__RETURN:
if(bRet)
{
pIter->pNode->dwCurrentStatus = dwNewStatus;
}
CloseServiceHandle(h_SCService);
CloseServiceHandle(h_SCHandle);
return bRet;当前服务的状态可以使用EnumServicesStatus函数获取，但是这个函数是获取系统中记录的所有的服务程序，在这样的情况下，我们只需要获取一个服务的状态，调用这个函数总有杀鸡用牛刀的意思，所以采用的是另外一个函数QueryServiceStatus，服务程序的主要状态有如下几种：
取值
| 状态描述
|
SERVICE_RUNNING
| 已启动
|
SERVICE_STOPPED
| 已停止
|
SERVICE_PAUSED
| 已暂停
|
SERVICE_CONTINUE_PENDING
| 正在恢复
|
SERVICE_PAUSE_PENDING
| 正在暂停
|
SERVICE_START_PENDING
| 正在启动
|
SERVICE_STOP_PENDING
| 正在停止
|
其中前几个是完成时，也就是完成了从一个状态到另一个的转化，而后面几个是进行时，正在这两种状态之间
获取服务的可控类型
在控制服务时不光要考虑服务程序当前的状态，还要考虑它是否支持这种状态，比如有的服务就不支持暂停和恢复操作
QueryServiceStatus 查询服务的状态信息
这个函数主要传递一个SERVICE_STATUS结构体的指针。这个结构体的定义如下：
typedef struct _SERVICE_STATUS {
DWORD dwServiceType;//服务类型
DWORD dwCurrentState; //当前状态
DWORD dwControlsAccepted;//允许的操作
DWORD dwWin32ExitCode;
DWORD dwServiceSpecificExitCode;
DWORD dwCheckPoint;
DWORD dwWaitHint;
} SERVICE_STATUS, *LPSERVICE_STATUS;改变服务的启动类型
服务的启动类型主要有开机启动、手动启动、以及禁止启动等项。改变启动类型的函数主要是：ChangeServiceConfig。函数原型如下：
BOOL WINAPI ChangeServiceConfig(
__in SC_HANDLE hService,
__in DWORD dwServiceType,//服务类型
__in DWORD dwStartType,//启动类型
__in DWORD dwErrorControl,
__in LPCTSTR lpBinaryPathName,//服务的主程序路径
__in LPCTSTR lpLoadOrderGroup,
__out LPDWORD lpdwTagId,
__in LPCTSTR lpDependencies,//依赖项
__in LPCTSTR lpServiceStartName,//服务名称
__in LPCTSTR lpPassword,//服务密码，主要用于控制服务
__in LPCTSTR lpDisplayName//服务的显示名称
);
函数中传递的都是服务的新信息，如果希望改变则填入相应的值，如果不想改变则对于DWORD类型的成员来说填入SERVICE_NO_CHANGE，对于指针类型的只需要填入NULL即可。
创建服务
创建服务主要使用函数CreateService，该函数的原型如下：
SC_HANDLE WINAPI CreateService(
__in SC_HANDLE hSCManager,
__in LPCTSTR lpServiceName,//服务名称
__in LPCTSTR lpDisplayName,//显示名称
__in DWORD dwDesiredAccess,//服务权限
__in DWORD dwServiceType,//服务类型
__in DWORD dwStartType,//服务启动类型
__in DWORD dwErrorControl,
__in LPCTSTR lpBinaryPathName,//主程序路径
__in LPCTSTR lpLoadOrderGroup,
__out LPDWORD lpdwTagId,
__in LPCTSTR lpDependencies,//依赖项
__in LPCTSTR lpServiceStartName,启动名称
__in LPCTSTR lpPassword//密码
);
在启动时需要填入一些信息系统的服务控制管理器保存这些信息，并根据其中的某些信息来启动这个服务，有的选项是必填的，比如服务名称，这个是用来唯一标识一个服务的，服务所在路径告知服务控制管理器启动哪个程序，而向依赖、密码等等信息可以不用填写。
下面是调用的例子
```cppp
SC_HANDLE hRet = ::CreateService(h_SCManager, lpServiceName, lpDisplayName, dwDesiredAccess, SERVICE_WIN32_OWN_PROCESS, dwStartType, SERVICE_ERROR_NORMAL,
lpBinaryPathName, NULL, NULL, lpDependencies, lpServiceStartName, lpPassword);
<div class="se-preview-section-delimiter">div>
SERVICE_WIN32_OWN_PROCESS表示服务类型是win32类型拥有独立进程的服务
SERVICE_ERROR_NORMAL表示服务程序返回的错误码是系统默认的错误码
删除服务
删除服务使用的函数是DeleteService，这个函数主要传入的是服务的句柄，这个句柄是由函数OpenService返回的。另外需要注意的是这个函数只对已停止的服务起作用，所以在删除之前需要将服务停止。
“`
SERVICE_WIN32_OWN_PROCESS表示服务类型是win32类型拥有独立进程的服务
SERVICE_ERROR_NORMAL表示服务程序返回的错误码是系统默认的错误码
## 删除服务
删除服务使用的函数是DeleteService，这个函数主要传入的是服务的句柄，这个句柄是由函数OpenService返回的。另外需要注意的是这个函数只对已停止的服务起作用，所以在删除之前需要将服务停止。
```cpp
BOOL bRet = FALSE;
DWORD dwSrvAcceptCtrl = GetSrvCtrlAccept(pIter->pNode->strSrvName);
if(0 == (dwSrvAcceptCtrl & SERVICE_ACCEPT_STOP)) //服务不能被删除
{
goto __RETURN;
}
//停止服务，函数CtrlService是我之前封装的用于控制服务。
bRet = CtrlService(pIter, SERVICE_CONTROL_STOP);
if(!bRet)
{
goto __RETURN;
}
bRet = ::DeleteService(h_SCService);
if (bRet)
{
DeleteItem(pIter->pNode);
}
__RETURN:
CloseServiceHandle(h_SCService);
CloseServiceHandle(h_SCManager);
return bRet;
