win32_delete_service
(PECL win32service >=0.1.0)
win32_delete_service — Видалення запису служби з бази даних SCM
Опис
win32_delete_service(string $servicename, string $machine = ?): void
Намагається видалити службу з бази даних 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.
Дивіться також
- win32_create_service() - Створює новий запис служби у базі даних SCM
- Коди помилок Win32