win32_delete_service
(PECL win32service >=0.1.0)
win32_delete_service — Удаляет запись службы из базы данных SCM
Описание
Пытается удалить службу из базы данных SCM. Для этого требуются права администратора.
Функция на самом деле просто помечает сервис для удаления. Если другие процессы (например, сервисный апплет) открыты, то удаление будет отложено до закрытия этих приложений. Если служба помечена для удаления, дальнейшие попытки её удаления не завершатся ошибкой, а попытки создать новую службу с этим именем также будут неудачными.
Список параметров
-
servicename -
Краткое название службы.
-
machine -
Необязательное имя машины. Если не указано, используется локальный компьютер.
Возвращаемые значения
Функция не возвращает значения после выполнения.
До версии 1.0.0, Возвращает WIN32_NO_ERROR в случае успешного завершения , false если была обнаружена проблема с параметрами или код ошибки Win32 при неудачном завершении работы.
Ошибки
Выбрасывает ValueError, если
значение servicename не указано.
Выбрасывает Win32ServiceException в случае возникновения ошибки.
Список изменений
| Версия | Описание |
|---|---|
| PECL win32service 1.0.0 |
Выбрасывает ValueError при неверных данных в параметрах,
ранее возвращалось false.
|
| PECL win32service 1.0.0 | Выбрасывает Win32ServiceException в случае возникновения ошибки, ранее возвращался Код ошибки Win32. |
| PECL win32service 1.0.0 | Тип возвращаемого значения теперь void, ранее был mixed. |
Примеры
Пример #1 Пример использования win32_delete_service()
Удаляет службу dummyphp.
<?php
win32_delete_service('dummyphp');
?>Смотрите также
- win32_create_service() - Создаёт новую запись службы в базе данных SCM
- Коды ошибок Win32
add a note
