Функция CloseServiceHandle закрывает дескриптор диспетчера управления службами или объекта службы.
Синтаксис
BOOL CloseServiceHandle( SC_HANDLE hSCObject ); |
Если функция завершается успешно, возвращаемое значение является ненулевым.
Если функция завершается ошибкой, возвращаемое значение - ноль. Чтобы получить дополнительную информацию об ошибке, вызовите 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). |
|
Замечания по платформе |
Не имеется |