win32_get_last_control_message
(PECL win32service >=0.1.0)
win32_get_last_control_message — Повертає останнє повідомлення, яке було надіслано цій службі.
Опис
win32_get_last_control_message(): int
Повертає код, що управляє, останній раз відправлений цьому процесу служби. Під час роботи як служба ви повинні періодично перевіряти це, щоб визначати, чи потрібно вашій службі припинити роботу.
Застереження
Починаючи з версії 0.2.0, функція працює лише у "cli" SAPI. На інших SAPI цю функцію вимкнено.
Список параметрів
Ця функція не має параметрів.
Значення, що повертаються
Повертає керуючу константу, яка буде однією з Констант повідомлень керування службою Win32Service WIN32_SERVICE_CONTROL_CONTINUE
WIN32_SERVICE_CONTROL_DEVICEEVENT
WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE
WIN32_SERVICE_CONTROL_INTERROGATE
WIN32_SERVICE_CONTROL_NETBINDADD
WIN32_SERVICE_CONTROL_NETBINDDISABLE
WIN32_SERVICE_CONTROL_NETBINDENABLE
WIN32_SERVICE_CONTROL_NETBINDREMOVE
WIN32_SERVICE_CONTROL_PARAMCHANGE
WIN32_SERVICE_CONTROL_PAUSE
WIN32_SERVICE_CONTROL_POWEREVENT
WIN32_SERVICE_CONTROL_PRESHUTDOWN
WIN32_SERVICE_CONTROL_SESSIONCHANGE
WIN32_SERVICE_CONTROL_SHUTDOWN
WIN32_SERVICE_CONTROL_STOP
Якщо значення знаходиться в діапазоні від 128 до 255, код керування налаштовується.
Помилки
До версії 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 0.2.0 | Функція працює тільки з "cli" SAPI. |
Дивіться також
- win32_start_service_ctrl_dispatcher() - Додає до Диспетчера служб скрипт, який може бути використаний, як служба із заданим ім'ям
- win32_set_service_status() - Оновлює статус служби
- win32_set_service_exit_mode() - Визначає або повертає режим виходу для поточної запущеної служби
- win32_set_service_exit_code() - Визначає чи повертає код виходу для поточної запущеної служби
- Константи повідомлень керування службою Win32Service