array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.win32-set-service-pause-resume-state.php', 1 => 'win32_set_service_pause_resume_state', 2 => 'Define ou retorna o recurso de pausa/retomada para o serviço em execução atual', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'Funções de win32service', ), 'prev' => array ( 0 => 'function.win32-set-service-exit-mode.php', 1 => 'win32_set_service_exit_mode', ), 'next' => array ( 0 => 'function.win32-set-service-status.php', 1 => 'win32_set_service_status', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/win32service/functions/win32-set-service-pause-resume-state.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_set_service_pause_resume_state

(PECL win32service >=1.1.0)

win32_set_service_pause_resume_state — Define ou retorna o recurso de pausa/retomada para o serviço em execução atual

Descrição

win32_set_service_pause_resume_state(bool $state = true): bool

Se o parâmetro state for fornecido, a capacidade de pausa/retomada será alterada.

Cuidado

Esta função funciona apenas no SAPI "cli" e no contexto de execução do serviço Windows. Em outros SAPI, esta função está desabilitada.

Parâmetros

state

true para ativar o recurso de pausa/retomada do serviço. false para desativar o recurso de pausa/retomada do serviço.

Valor Retornado

Retorna o estado atual ou antigo da capacidade de pausa/retomada.

Erros/Exceções

Antes da versão 1.0.0, se o SAPI não for "cli", esta função emite um erro de nível E_ERROR.

A partir da versão, lança uma exceção Win32ServiceException se o SAPI não for "cli".

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.

Veja Também