(PECL win32service >=0.1.0)
win32_set_service_status — Actualiza el estado de un servicio
Informa al SCM del estado actual de un servicio en ejecución. Esta llamada solo es válida para un proceso de servicio en ejecución.
Desde la versión 0.2.0, esta función solo funciona en línea de comandos ("cli" SAPI). Está deshabilitada en otros casos.
status
El código de estado del servicio, uno de
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
Este valor será incrementado periódicamente por el servicio para reportar su progreso durante las operaciones de inicio, detención, pausa o reanudación. Por ejemplo, el servicio incrementará este valor cuando haya completado cada paso de su inicialización durante el inicio.
checkpoint
solo es válido cuando
status
es una de las siguientes constantes:
WIN32_SERVICE_STOP_PENDING
,
WIN32_SERVICE_START_PENDING
,
WIN32_SERVICE_CONTINUE_PENDING
o
WIN32_SERVICE_PAUSE_PENDING
.
No devuelve ningún valor.
Antes de la versión 1.0.0, Devuelve WIN32_NO_ERROR
en caso de éxito, false
si hay un problema con los parámetros o Código de error Win32 en caso de error.
Antes de la versión 1.0.0, si esta función se utiliza fuera del SAPI "cli"
, se emitirá
un error E_ERROR
.
A partir de la versión 1.0.0, lanzará una
Win32ServiceException si el SAPI no es
"cli"
Versión | Descripción |
---|---|
PECL win32service 1.0.0 |
Lanzará una ValueError si un argumento es inválido,
anteriormente false era retornado.
|
PECL win32service 1.0.0 | Lanzará una Win32ServiceException en caso de error, anteriormente un Código de error Win32 era retornado. |
PECL win32service 1.0.0 | El tipo de retorno es ahora void, anteriormente era mixed. |
PECL win32service 0.2.0 | Esta función solo funciona en línea de comandos ("cli" SAPI). |