win32_send_custom_control
(PECL win32service >=0.4.0)
win32_send_custom_control — Надсилає елемент керування, що настроюється, до служби
Опис
win32_send_custom_control(string $servicename, int $control, string $machine = ?): void
Смотрите» функцію Microsoft ControlService для отримання додаткових відомостей.
Список параметрів
servicename
Коротка назва служби.
control
Значення настроюваного елемента керування від 128 до 255.
machine
Необов'язкове ім'я машини. Якщо не вказано, використовується локальний комп'ютер.
Значення, що повертаються
Функція не повертає значення після виконання.
До версії 1.0.0, Повертає WIN32_NO_ERROR у разі успішного завершення false якщо була виявлена проблема з параметрами або код помилки Win32 при невдалому завершенні роботи.
Помилки
До версії 1.0.0, якщо значення control не знаходиться між 128 та 255, функція видавала помилку рівня E_ERROR
Викидає ValueError, если значениеservicename не вказано.
Викидає ValueError, если значениеcontrol не знаходиться між 128 та 255.
Викидає Win32ServiceExceptionв случае возникновения ошибки.
список змін
| Версия | Опис |
|---|---|
| PECL win32service 1.0.0 | Викидає ValueError при невірних даних у параметрах, що раніше поверталося false |
| PECL win32service 1.0.0 | Викидає Win32ServiceException у разі виникнення помилки, раніше повертався Код помилки Win32 |
| PECL win32service 1.0.0 | Тип повертається тепер void, раніше був mixed |
Дивіться також
- win32_start_service() - Запускає службу
- win32_stop_service() - зупиняє службу
- win32_pause_service() - зупиняє службу
- win32_continue_service() - Відновлює роботу зупиненої служби
- Коди помилок Win32