win32_set_service_status
(PECL win32service >=0.1.0)
win32_set_service_status — Update the service status
Описание
$status
, int $checkpoint = 0
) : voidInforms the SCM of the current status of a running service. This call is only valid for a running service process.
Since version 0.2.0, this function work only in "cli" SAPI. On other SAPI this function is disabled.
Список параметров
-
status -
The service status code, one of
WIN32_SERVICE_RUNNING,WIN32_SERVICE_STOPPED,WIN32_SERVICE_STOP_PENDING,WIN32_SERVICE_START_PENDING,WIN32_SERVICE_CONTINUE_PENDING,WIN32_SERVICE_PAUSE_PENDING,WIN32_SERVICE_PAUSED. -
checkpoint -
The checkpoint value the service increments periodically to report its progress during a lengthy start, stop, pause, or continue operation. For example, the service should increment this value as it completes each step of its initialization when it is starting up.
The
checkpointis only valid when thestatusis one ofWIN32_SERVICE_STOP_PENDING,WIN32_SERVICE_START_PENDING,WIN32_SERVICE_CONTINUE_PENDINGorWIN32_SERVICE_PAUSE_PENDING.
Возвращаемые значения
Эта функция не возвращает значения после выполнения.
Prior to version 1.0.0, Возвращает WIN32_NO_ERROR в случае успешного завершения , false если была обнаружена проблема с параметрами или код ошибки Win32 при неудачном завершении работы.
Ошибки
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 1.0.0 | The return type is now void, previously it was mixed. |
| PECL win32service 0.2.0 |
This function works only in the "cli" SAPI.
|
Смотрите также
- win32_start_service_ctrl_dispatcher() - Добавляет в Диспетчер Служб скрипт, который может быть использован, как служба с заданным именем
- win32_get_last_control_message() - Returns the last control message that was sent to this service
- 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 Status Constants