CloseServiceHandle
The CloseServiceHandle
function closes a handle to a service control manager database as returned by
the OpenSCManager
function, or it closes a handle to a service object as returned by either the OpenService or CreateService function.
BOOL CloseServiceHandle(
|
SC_HANDLE hSCObject |
// handle to
service or service control manager database |
|
); |
|
Parameters
hSCObject
Identifies
the service control manager database or the service object to close.
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.
Errors
The following
error code may be set by the service control manager. Other error codes may be
set by registry functions that are called by the service control manager.
|
Value |
Meaning |
|
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.
See Also