Функция CloseServiceHandle

Функция CloseServiceHandle закрывает дескриптор диспетчера управления службами или объекта службы.

Синтаксис

BOOL CloseServiceHandle( 
  SC_HANDLE hSCObject 
); 

Параметры

hSCObject
[in] Дескриптор объекта диспетчера управления службами или объекта службы, который  закрывается. Дескрипторы объектов менеджера управления службами возвращаются функцией OpenSCManager, а дескрипторы объектов служб возвращаются или функцией OpenService или функцией CreateService.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение является ненулевым. 

Если функция завершается ошибкой, возвращаемое значение - ноль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Следующий код ошибки может установиться диспетчером управления службами. Другие коды ошибки могут установиться функциями реестра, которые вызывает диспетчер управления службами.

Код возврата Описание
ERROR_INVALID_HANDLE Указанный дескриптор недействителен.

Замечания

Функция CloseServiceHandle не разрушает объект диспетчера управления службами, на который ссылается дескриптор. Объект диспетчера управления службами не может быть разрушен. Объект службы может быть разрушен, при помощи вызова функции DeleteService.

Демонстрационный код

Пример смотри в статье Удаление службы.

Смотри также

Обзор Службы, Функции, используемые службамиCreateService, DeleteService, OpenSCManager, OpenService

Размещение и совместимость CloseServiceHandle

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT Workstation

Да

е

Windows Me

Нет

н

Windows 98

Нет

т

Windows 95

Нет

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    

Используемая библиотека

Advapi32.lib

Используемая DLL advapi32.dll
 Заголовочный файл  

- объявлено в

Winsvc.h

 - включено в

Windows.h

 Unicode

Реализуется как ChangeServiceConfigW (Unicode) и ChangeServiceConfigA (ANSI).

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz