Exclui uma entrada de serviço do banco de dados do GCS

# win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_service — Exclui uma entrada de serviço do banco de dados do GCS

### Descrição

function win32_delete_service(string `$servicename`, string `$machine` = `null`): void

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.

### Parâmetros

`servicename`

  O nome abreviado do serviço.

`machine`

  O 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 será 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.

### Exemplos

Exemplo #1 Um exemplo de win32_delete_service()

Exclui o serviço dummyphp.

    <?php
    win32_delete_service('dummyphp');
    ?>

### Veja Também

- win32_create_service() - Cria uma nova entrada de serviço no banco de dados do GCS
- Códigos de Erro Win32

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