array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', 2 => 'Exclui uma entrada de serviço do banco de dados do GCS', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Funções de win32service', ), 'prev' => array ( 0 => 'function.win32-create-service.php', 1 => 'win32_create_service', ), 'next' => array ( 0 => 'function.win32-get-last-control-message.php', 1 => 'win32_get_last_control_message', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/win32service/functions/win32-delete-service.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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