(PECL win32service >=0.1.0)
win32_get_last_control_message — Возвращает последнее управляющее сообщение, которое отправили этой службе
Функция возвращает управляющий код, который отправили этому процессу службы в последний раз. При работе в качестве службы требуется периодически проверять это, чтобы определять, требуется ли службе прекратить работу.
С версии 0.2.0 функция работает только через SAPI-интерфейс CLI. Через другие 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 функция выдавала ошибку уровня E_ERROR
при вызове не через SAPI-интерфейс "cli".
С версии 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 |
Функция работает только через SAPI-интерфейс "cli".
|