(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".
|