(PECL win32service >=0.1.0)
win32_set_service_status — Обновляет статус службы
$status
, int $checkpoint
= 0): voidИнформирует SCM о текущем состоянии работающей службы. Этот вызов действителен только для запущенного сервисного процесса.
Начиная с версии 0.2.0, функция работает только в "cli" SAPI. На других 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, выбрасывает
Win32ServiceException, если SAPI не
"cli"
Версия | Описание |
---|---|
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 |
Функция работает только с "cli" SAPI.
|