win32_start_service
(PECL win32service >=0.1.0)
win32_start_service — Запуск служби
Опис
win32_start_service(string $servicename, string $machine = ?): void
Здійснює спробу запуску зазначеної служби. Зазвичай вимагає адміністративних привілеїв або облікового запису з відповідним чином налаштованим ACL для сервісу.
Список параметрів
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 |
| PECL win32service 0.3.0 | Ця функція більше не потребує привілею адміністратора, якщо для користувача, що використовується, коректно налаштовано ACL. |
Дивіться також
- win32_stop_service() - зупиняє службу
- win32_pause_service() - зупиняє службу
- win32_continue_service() - Відновлює роботу зупиненої служби
- win32_send_custom_control() - Відправляє налаштований елемент керування до служби
- Коди Помилок Win32