« win32\_set\_service\_exit\_modewin32\_start\_service\_ctrl\_dispatcher »PHP Manualwin32service

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, функція працює лише у "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.

Дивіться також