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

Статья
03/04/2024

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

Синтаксис

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