Inicia um serviço

Descrição

win32_start_service(string $servicename, string $machine = null): void

Tenta iniciar o serviço nomeado. Requer privilégios administrativos ou uma conta com direitos apropriados definidos na ACL do serviço.

Parâmetros

servicename: O nome abreviado do serviço.
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

Uma exceção ValueError é lançada se o valor do parâmetro servicename estiver vazio.

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.
PECL win32service 0.3.0	Esta função não requer mais uma conta de administrador se a ACL estiver definida para outra conta.

Veja Também

win32_stop_service() - Interrompe um serviço
win32_pause_service() - Pausa um serviço
win32_continue_service() - Continua um serviço pausado
win32_send_custom_control() - Envia um controle personalizado para o serviço
Códigos de Erro Win32