array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.win32-get-last-control-message.php', 1 => 'win32_get_last_control_message', 2 => 'Возвращает последнее управляющее сообщение, которое отправили этой службе', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'win32service', ), 'prev' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', ), 'next' => array ( 0 => 'function.win32-get-service-env-vars.php', 1 => 'win32_get_service_env_vars', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/win32service/functions/win32-get-last-control-message.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_get_last_control_message

(PECL win32service >=0.1.0)

win32_get_last_control_message — Возвращает последнее управляющее сообщение, которое отправили этой службе

Описание

win32_get_last_control_message(): int

Функция возвращает управляющий код, который отправили этому процессу службы в последний раз. При работе в качестве службы требуется периодически проверять это, чтобы определять, требуется ли службе прекратить работу.

Предостережение

С версии 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".

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