(PECL win32service >=0.1.0)
win32_set_service_status — Обновляет статус службы
Информирует SCM о текущем состоянии работающей службы. Этот вызов действителен только для запущенного сервисного процесса.
С версии 0.2.0 функция работает только через SAPI-интерфейс CLI. Через другие SAPI-интерфейсы функция не работает.
status
Код статуса службы из списка:
WIN32_SERVICE_RUNNING,
WIN32_SERVICE_STOPPED,
WIN32_SERVICE_STOP_PENDING,
WIN32_SERVICE_START_PENDING,
WIN32_SERVICE_CONTINUE_PENDING,
WIN32_SERVICE_PAUSE_PENDING,
WIN32_SERVICE_PAUSED.
checkpointЗначение контрольной точки, которое служба периодически увеличивает, чтобы сообщить о своём прогрессе во время длительного запуска, остановки, паузы или продолжения работы. Например, служба должна увеличивать это значение на единицу по мере завершения каждого шага своей инициализации при запуске.
Контрольная точка checkpoint действительна, только если
статус status равен значению из списка:
WIN32_SERVICE_STOP_PENDING,
WIN32_SERVICE_START_PENDING,
WIN32_SERVICE_CONTINUE_PENDING
или WIN32_SERVICE_PAUSE_PENDING.
Функция не возвращает значения после выполнения.
До версии 1.0.0, Функция возвращает
WIN32_NO_ERROR
в случае успешного завершения , false, если возникла проблема с параметрами,
или
код ошибки Win32, если возникла ошибка.
До версии 1.0.0 при вызове не через SAPI-интерфейс CLI
функция выдаёт ошибку уровня E_ERROR.
С версии 1.0.0 при вызове не через SAPI-интерфейс CLI функция выбрасывает исключение 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.2.0 |
Функция работает только с SAPI-интерфейсом CLI.
|