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


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

Помечает указанную службу для удаления из базы данных диспетчера управления службами.

Синтаксис

BOOL DeleteService(
  [in] SC_HANDLE hService
);

Параметры

[in] hService

Дескриптор службы. Этот дескриптор возвращается функцией OpenService или CreateService и должен иметь право доступа DELETE. Дополнительные сведения см. в разделе Безопасность службы и права доступа.

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

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

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
Дескриптор не имеет права доступа DELETE.
ERROR_INVALID_HANDLE
Указанный дескриптор недопустим.
ERROR_SERVICE_MARKED_FOR_DELETE
Указанная служба уже помечена для удаления.

Комментарии

Функция DeleteService помечает службу для удаления из базы данных диспетчера управления службами. Запись базы данных не удаляется до тех пор, пока все открытые дескрипторы службы не будут закрыты вызовами функции CloseServiceHandle , а служба не будет запущена. Работающая служба останавливается вызовом функции ControlService с кодом SERVICE_CONTROL_STOP элемента управления. Если не удается остановить службу, запись базы данных удаляется при перезапуске системы.

Диспетчер управления службами удаляет службу, удаляя раздел службы и его подразделы из реестра.

Примеры

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

Требования

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

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

CloseServiceHandle

ControlService

CreateService

OpenService

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

Установка, удаление и перечисление службы