Platform SDK: DLLs, Processes, and Threads |
The CloseServiceHandle function closes the following types of handles:
BOOL CloseServiceHandle( SC_HANDLE hSCObject // handle to service or SCM object );
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.
Error code | Meaning |
---|---|
ERROR_INVALID_HANDLE | The specified handle is invalid. |
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.
Windows NT/2000: Requires Windows NT 3.1 or later.
Header: Declared in Winsvc.h; include Windows.h.
Library: Use Advapi32.lib.
Services Overview, Service Functions, CreateService, DeleteService, OpenSCManager, OpenService