CloseServiceHandle

The CloseServiceHandle function closes the following types of handles:

• a handle to a service control manager object as returned by the OpenSCManager function
• 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

Handle to the service control manager object 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 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.

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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winsvc.h.
  Import Library: Use advapi32.lib.

See Also

Services Overview, Service Functions, CreateService, DeleteService, OpenSCManager, OpenService