array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.win32-set-service-status.php', 1 => 'win32_set_service_status', 2 => 'Обновляет статус службы', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'win32service', ), 'prev' => array ( 0 => 'function.win32-set-service-pause-resume-state.php', 1 => 'win32_set_service_pause_resume_state', ), 'next' => array ( 0 => 'function.win32-start-service.php', 1 => 'win32_start_service', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/win32service/functions/win32-set-service-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_set_service_status

(PECL win32service >=0.1.0)

win32_set_service_status — Обновляет статус службы

Описание

win32_set_service_status(int $status, int $checkpoint = 0): void

Информирует 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.

Смотрите также