win32_query_service_status

(PECL win32service >=0.1.0)

win32_query_service_status — Consulta o status de um serviço

Descrição

win32_query_service_status(string $servicename, string $machine = null): array

Consulta o status atual de um serviço, retornando um array de informações.

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

Retorna um array que consiste nas informações abaixo em caso de sucesso.

Antes da versão 1.0.0,, false se houver um problema com os parâmetros ou um Código de Erro Win32 em caso de falha.

ServiceType: O tipo de serviço. Consulte as Máscaras de bit de tipo de serviço do Win32Service.
CurrentState: O status atual. Consulte as Constantes de status de serviço do Win32Service.
ControlsAccepted: Quais controles de serviço são aceitos pelo serviço. Consulte as Máscaras de bits aceitas de mensagem de controle de serviço Win32Service.
Win32ExitCode: Se o serviço foi encerrado, o código de retorno do processo. Este valor é igual a WIN32_ERROR_SERVICE_SPECIFIC_ERROR se o modo de saída não for normal. Consulte os códigos de erro do Win32Service e a função win32_set_service_exit_mode().
ServiceSpecificExitCode: Se o serviço for encerrado com uma condição de erro, o código específico do serviço incluído no registro de eventos ficará visível aqui. Este valor é igual ao valor definido por win32_set_service_exit_code().
CheckPoint: Se o serviço estiver sendo encerrado, contém o número do ponto de verificação atual. Isso é usado pelo GCS como uma espécie de pulsação para detectar um processo de serviço bloqueado. O valor do ponto de verificação é melhor interpretado em conjunto com o valor WaitHint.
WaitHint: Se o serviço estiver sendo encerrado, ele definirá WaitHint para um valor de ponto de verificação que indicará 100% de conclusão. Isto pode ser usado para implementar um indicador de progresso.
ProcessId: O identificador de processo do Windows. Se for 0, o processo não está em execução.
ServiceFlags: As opções do serviço. Consulte as Constantes de opção de serviço do Win32Service.

Erros/Exceções

Uma exceção ValueError será lançada se o valor do parâmetro servicename estiver vazio.

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 é array, anteriormente era mixed.

Veja Também

Constantes predefinidas Win32Service

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 1 note

down

demers dot alex at gmail dot com ¶

15 years ago

This function will return an array containing the above information as a return value, but if this fails it will return an integer which is a System Error Code. All the System Error Codes can be found here:

http://msdn.microsoft.com/en-us/library/ms681381%28VS.85%29.aspx

In my case, it returned 5, in which I immediately knew why and fixed the issue right away.

In the case of mnemotronic at netscape dot net, here in the documentation notes, it returned 1060 which is:

ERROR_SERVICE_DOES_NOT_EXIST
1060 (0x424)
The specified service does not exist as an installed service.

Again, it should not return FALSE, instead an System Error Code for Windows.

＋adicione uma nota