Поделиться через


Функция CloseServiceHandle (winsvc.h)

Закрывает дескриптор для диспетчера элементов управления службой или объекта службы.

Синтаксис

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

Параметры

[in] hSCObject

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

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

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

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

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

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

Комментарии

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

Примеры

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

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header winsvc.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

См. также раздел

CreateService

DeleteService

OpenSCManager

OpenService

Дескрипторы SCM

Функции службы