closeServiceHandle 函数 (winsvc.h)
关闭服务控制管理器或服务对象的句柄。
语法
BOOL CloseServiceHandle(
[in] SC_HANDLE hSCObject
);
参数
[in] hSCObject
服务控制管理器对象的句柄或要关闭的服务对象的句柄。 服务控制管理器对象的句柄由 OpenSCManager 函数返回,服务对象的句柄由 OpenService 或 CreateService 函数返回。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
服务控制管理器可以设置以下错误代码。 其他错误代码可由服务控制管理器调用的注册表函数设置。
返回代码 | 说明 |
---|---|
|
指定的句柄无效。 |
注解
CloseServiceHandle 函数不会销毁句柄引用的服务控制管理器对象。 无法销毁服务控制管理器对象。 可以通过调用 DeleteService 函数来销毁服务对象。
示例
有关示例,请参阅 删除服务。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | winsvc.h (包括 Windows.h) |
Library | Advapi32.lib |
DLL | Advapi32.dll |