Функция 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).
Замечания по платформе		Не имеется

Назад в оглавление

На главную страницу

В оглавление справки