(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" .
|