Envia um controle personalizado para o serviço

# win32_send_custom_control

(PECL win32service >=0.4.0)

win32_send_custom_control — Envia um controle personalizado para o serviço

### Descrição

function win32_send_custom_control(string `$servicename`, int `$control`, string `$machine` = `null`): void

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open