closeServiceHandle 函数 (winsvc.h)

关闭服务控制管理器或服务对象的句柄。

语法

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

参数

[in] hSCObject

服务控制管理器对象的句柄或要关闭的服务对象的句柄。 服务控制管理器对象的句柄由 OpenSCManager 函数返回,服务对象的句柄由 OpenServiceCreateService 函数返回。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

服务控制管理器可以设置以下错误代码。 其他错误代码可由服务控制管理器调用的注册表函数设置。

返回代码 说明
ERROR_INVALID_HANDLE
指定的句柄无效。

注解

CloseServiceHandle 函数不会销毁句柄引用的服务控制管理器对象。 无法销毁服务控制管理器对象。 可以通过调用 DeleteService 函数来销毁服务对象。

示例

有关示例,请参阅 删除服务

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winsvc.h (包括 Windows.h)
Library Advapi32.lib
DLL Advapi32.dll

另请参阅

CreateService

DeleteService

OpenSCManager

OpenService

SCM 句柄

服务函数