array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.win32-pause-service.php', 1 => 'win32_pause_service', 2 => 'Pausa um serviço', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Funções de win32service', ), 'prev' => array ( 0 => 'function.win32-get-service-env-vars.php', 1 => 'win32_get_service_env_vars', ), 'next' => array ( 0 => 'function.win32-query-service-status.php', 1 => 'win32_query_service_status', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/win32service/functions/win32-pause-service.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_pause_service

(PECL win32service >=0.1.0)

win32_pause_service — Pausa um serviço

Descrição

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

Pausa um 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 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.
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