PHP Conference Nagoya 2025

win32_send_custom_control

(PECL win32service >=0.4.0)

win32_send_custom_controlEnvia um controle personalizado para o serviço

Descrição

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

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top