Функция DeleteService отмечает указанную службу для удаления из базы данных диспетчера управления службами.
Синтаксис
BOOL DeleteService( SC_HANDLE hService ); |
Параметры
hService
[in] Дескриптор службы. Этот дескриптор возвращается функцией OpenService или CreateService и он должен иметь право доступа DELETE. Дополнительную информацию смотри в статье Защита службы и права доступа.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение является ненулевым.
Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Следующие коды ошибок могут быть установлены диспетчером управления службами. Другие могут быть установлены функциями реестра, которые вызывает диспетчер управления службами.
| Код возврата | Описание |
|---|---|
| ERROR_ACCESS_DENIED | Дескриптор не имеет права доступа DELETE. |
| ERROR_INVALID_HANDLE | Указанный дескриптор недействителен. |
| ERROR_SERVICE_MARKED_FOR_DELETE | Указанная служба была уже отмечена для удаления. |
Замечания
Функция DeleteService отмечает службу для удаления из базы данных диспетчера управления службами. Точка входа в базу данных не удаляется до тех пор, пока все открытые дескрипторы службы не будут закрыты вызовами функции CloseServiceHandle, а службы не запущены. Запущенная служба останавливается вызовом функции ControlService с управляющим кодом SERVICE_CONTROL_STOP. Если служба не может остановиться, точка входа в базу данных удаляется, когда система перезапускается.
Диспетчер управления службами удаляет службу, удаляя ключ службы и его подключи из реестра.
Демонстрационный код
Пример смотри в статье Удаление cлужбы.
Смотри также
Обзор Службы, Функции, используемые службами, CloseServiceHandle, ControlService, CreateService, OpenService
|
Размещение и совместимость DeleteService |
||
| К |
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 |
Нет |
|
| Замечания по платформе |
Не имеется |
|