(PECL win32service >=0.1.0)
win32_set_service_status — Update the service status
$status
[, int $checkpoint
= 0
] ) : boolInforms 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 checkpoint
is only valid when the
status
is one of
WIN32_SERVICE_STOP_PENDING
,
WIN32_SERVICE_START_PENDING
,
WIN32_SERVICE_CONTINUE_PENDING
or
WIN32_SERVICE_PAUSE_PENDING
.
Gibt im Erfolgsfall TRUE
zurück oder FALSE
, wenn es ein Problem mit den Parametern gab oder einen Win32-Fehlercode im Fehlerfall.
If SAPI is not "cli", this function emits an E_ERROR
level error.
Version | Beschreibung |
---|---|
0.2.0 | This function works only in the "cli" SAPI. |