win32_set_service_status
win32_set_service_status
Update the service status
void **win32_set_service_status** int $status int $checkpoint
Informs the SCM of the current status of a running service. This call is only valid for a running service process.
Let op: > 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
checkpointThe 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 is only valid when the
is one of
,
,
or
.
`checkpoint``status``WIN32_SERVICE_STOP_PENDING``WIN32_SERVICE_START_PENDING``WIN32_SERVICE_CONTINUE_PENDING``WIN32_SERVICE_PAUSE_PENDING`
return.void
Prior to version 1.0.0, win32service.noerror.false.error
Prior to version 1.0.0, if the SAPI is not , this function emits an
level error.
"cli"``E_ERROR
As of version 1.0.0, will throw a
if SAPI is not
Win32ServiceException``"cli"
win32_start_service_ctrl_dispatcher``win32_get_last_control_message``win32_set_service_exit_mode``win32_set_service_exit_codeWin32Service Service Status Constants