win32_send_custom_control
(PECL win32service >=0.4.0)
win32_send_custom_control — Envia um controle personalizado para o serviço
Descrição
Consulte a » Função ControlService da Microsoft para mais detalhes.
Parâmetros
servicename-
O nome abreviado do serviço.
control-
O valor do contole personalizado entre 128 e 255.
machine-
Nome da máquina opcional. Se omitido, a máquina local será usada.
Valor Retornado
Nenhum valor é retornado.
Antes da versão 1.0.0, retornava WIN32_NO_ERROR em caso de sucesso, false se houver um problema com os parâmetros ou um Código de Erro Win32 em caso de falha.
Erros/Exceções
Antes da versão 1.0.0, se o valor de controle não estiver entre 128 e 255, esta função
emite um erro de nível E_ERROR.
Uma exceção ValueError será lançada se o
valor do parâmetro servicename estiver vazio.
Uma exceção ValueError é lançada se o
valor do parâmetro control não estiver entre 128 e 255.
Uma exceção Win32ServiceException é lançada em caso de erro.
Registro de Alterações
| 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 1.0.0 | O tipo de retorno agora é void, anteriormente era mixed. |
Veja Também
- win32_start_service() - Inicia um serviço
- win32_stop_service() - Interrompe um serviço
- win32_pause_service() - Pausa um serviço
- win32_continue_service() - Continua um serviço pausado
- Códigos de Erro Win32