CloseServiceHandle

最新推荐文章于 2024-11-11 14:11:14 发布

原创最新推荐文章于 2024-11-11 14:11:14 发布 · 2.4k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#service #manager #function #object #windows #server

博客主要介绍了CloseServiceHandle函数，该函数用于关闭服务控制管理器或服务对象的句柄。说明了其参数情况，成功时返回非零值，失败返回零，还可通过GetLastError获取扩展错误信息。同时提到该函数不会销毁服务控制管理器对象，服务对象可通过DeleteService函数销毁。

CloseServiceHandle

The CloseServiceHandle function closes a handle to a service control manager or service object.

BOOL CloseServiceHandle(
  SC_HANDLE hSCObject
);

Parameters

hSCObject

[in] Handle to the service control manager object or the service object to close. Handles to service control manager objects are returned by the OpenSCManager function, and handles to service objects are returned by either the OpenService or CreateService function

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

The following error code can be set by the service control manager. Other error codes can be set by registry functions that are called by the service control manager.

Return code	Description
ERROR_INVALID_HANDLE	The specified handle is invalid.

Remarks

The CloseServiceHandle function does not destroy the service control manager object referred to by the handle. A service control manager object cannot be destroyed. A service object can be destroyed by calling the DeleteService function.

Example Code

For an example, see Deleting a Service.

Requirements

Client	Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation.
Server	Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server.
Header	Declared in Winsvc.h; include Windows.h.
Library	Link to Advapi32.lib.
DLL	Requires Advapi32.dll.