(PECL win32service >=0.1.0)
win32_get_last_control_message — Retorna a última mensagem de controle enviada para este serviço
Retorna o código de controle enviado pela última vez para este processo de serviço. Ao executar como um serviço, isto deve ser verificado periodicamente para determinar se o serviço precisa parar de funcionar.
Desde a versão 0.2.0, esta função funciona somente no SAPI CLI. Em outros SAPI, esta função é desabilitada.
Esta função não possui parâmetros.
Retorna uma constante de controle que será uma das
Constantes de mensagem de controle de serviço Win32Service:
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
.
Se o valor estiver entre 128 e 255, o código de controle é personalizado.
Antes da versão 1.0.0, Se o SAPI não for "cli"
, esta função emite um
erro de nível E_ERROR
.
A partir da versão 1.0.0, é lançada uma exceção
Win32ServiceException se o SAPI não for
"cli"
.
Versão | Descrição |
---|---|
PECL win32service 1.0.0 |
Lança uma exceção ValueError em caso de dados inválidos nos parâmetros,
anteriormente retornava false .
|
PECL win32service 1.0.0 | Lança uma exceção Win32ServiceException em caso de erro, anteriormente um Código de Erro Win32 era retornado. |
PECL win32service 0.2.0 |
Esta função funciona apenas no SAPI "cli" .
|