(PECL win32service >=0.1.0)
win32_delete_service — Exclui uma entrada de serviço do banco de dados do GCS
Tentativas de excluir um serviço do banco de dados do GCS. Privilégios administrativos são necessários para que isso seja bem-sucedido.
Esta função apenas marca o serviço para exclusão. Se outros processos (como o miniaplicativo de serviços) estiverem abertos, a exclusão será adiada até que esses aplicativos sejam fechados. Se um serviço estiver marcado para exclusão, outras tentativas de excluí-lo falharão e as tentativas de criar um novo serviço com esse nome também falharão.
servicenameO nome abreviado do serviço.
machineO nome da máquina opcional. Se omitido, a máquina local será usada.
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.
Uma exceção ValueError será lançada se o
valor do parâmetro servicename estiver vazio.
Uma exceção Win32ServiceException é lançada em caso de erro.
| 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. |
Exemplo #1 Um exemplo de win32_delete_service()
Exclui o serviço dummyphp.
<?php
win32_delete_service('dummyphp');
?>