(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');
?>