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

Статья
03/13/2024

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

Синтаксис

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