win32_get_last_control_message
(PECL win32service >=0.1.0)
win32_get_last_control_message — Returns the last control message that was sent to this service
Описание
Returns the control code that was last sent to this service process. When running as a service you should periodically check this to determine if your service needs to stop running.
Since version 0.2.0, this function work only in "cli" SAPI. On other SAPI this function is disabled.
Возвращаемые значения
Returns a control constant which will be one of the
Win32Service Service Control Message Constants:
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.
If the value is between 128 and 255, the control code is custom.
Ошибки
Prior to version 1.0.0, if the SAPI is not "cli", this function emits an
E_ERROR level error.
As of version 1.0.0, will throw a
Win32ServiceException if SAPI is not
"cli"
Список изменений
| Версия | Описание |
|---|---|
| PECL win32service 1.0.0 |
Throws a ValueError on invalid data in parameters,
previously false was returned.
|
| PECL win32service 1.0.0 | Throws a Win32ServiceException on error, previously a Win32 Error Code was returned. |
| PECL win32service 0.2.0 |
This function works only in the "cli" SAPI.
|
Смотрите также
- win32_start_service_ctrl_dispatcher() - Добавляет в Диспетчер Служб скрипт, который может быть использован, как служба с заданным именем
- win32_set_service_status() - Update the service status
- win32_set_service_exit_mode() - Define or return the exit mode for the current running service
- win32_set_service_exit_code() - Define or return the exit code for the current running service
- Win32Service Service Control Message Constants