服务程序是windows上重要的一类程序,它们虽然不与用户进行界面交互,但是它们对于系统有着重要的意义。windows上为了管理服务程序提供了一个特别的程序:服务控制管理程序,系统上关于服务控制管理的API基本上都与这个程序打交道。下面通过对服务程序的操作来说明这些API函数
在windows系统中有专门用来存储服务信息的数据库,而获取系统服务信息主要是通过在这样的数据库中查找。所用到的函数主要有:
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 参数 函数如果调用成功,则会返回一个操作数据库的句柄,以后的关于服务的操作都已这个参数作为第一个参数。
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函数获取
SC_HANDLE WINAPI OpenService(
__in SC_HANDLE hSCManager, //服务数据库的句柄
__in LPCTSTR lpServiceName,//服务的名称
__in DWORD dwDesiredAccess//以何种权限打开,为了方便一般填入SERVICE_ALL_ACCESS所有权限
);
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;
服务控制主要控制服务的启动,暂停,恢复,停止等等。
BOOL WINAPI StartService(
__in SC_HANDLE hService,
__in DWORD dwNumServiceArgs,//启动参数的个数
__in LPCTSTR* lpServiceArgVectors//参数列表指针
);
这个函数有点类似于main函数,main函数可以传递命令行参数给程序,以便实现程序与用户的交互,这里同样可以传递参数,以便服务完成特定的功能,当第二个参数为0时第三个参数为NULL
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 | 正在停止 |
其中前几个是完成时,也就是完成了从一个状态到另一个的转化,而后面几个是进行时,正在这两种状态之间
在控制服务时不光要考虑服务程序当前的状态,还要考虑它是否支持这种状态,比如有的服务就不支持暂停和恢复操作
这个函数主要传递一个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;