CloseServiceHandle function

Closes a handle to a service control manager or service object.

Syntax


BOOL WINAPI CloseServiceHandle(
  _In_  SC_HANDLE hSCObject
);

Parameters

hSCObject [in]

A 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 value

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 codeDescription
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.

Examples

For an example, see Deleting a Service.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Winsvc.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

CreateService
DeleteService
OpenSCManager
OpenService
SCM Handles
Service Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.