PHP Velho Oeste 2024

win32_start_service

(PECL win32service >=0.1.0)

win32_start_serviceStarts a service

Descrição

win32_start_service(string $servicename, string $machine = ?): void

Attempts to start the named service. Requires administrative privileges or an account with appropriate rights set in the service's ACL.

Parâmetros

servicename

The short name of the service.

machine

Optional machine name. If omitted, the local machine is used.

Valor Retornado

Nenhum valor é retornado.

Prior to version 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

A ValueError is thrown if the value of servicename parameter is empty.

A Win32ServiceException is thrown on error.

Registro de Alterações

Versão Descrição
PECL win32service 1.0.0 Throws a ValueError on invalid data in parameters, previously false was returned.
PECL win32service 1.0.0 Throws a Win32ServiceException on error, previously a Win32 Error Code was returned.
PECL win32service 1.0.0 The return type is now void, previously it was mixed.
PECL win32service 0.3.0 This function does not longer require an administrator account if ACL is set for another account.

Veja Também

add a note add a note

User Contributed Notes 2 notes

up
-1
gunday at poczta dot onet dot pl
16 years ago
If you get a 1053 error when trying to launch your service, check your service script for errors!

E.g. if you have some syntax errors, the service will attempt to run the php interpreter, but the script won't answer to the service manager with
win32_start_service_ctrl_dispatcher('servicename').

Don't think it is because the call comes to late. It just never came, because there were errors. Test your services with CLI php and then try to run the service.
up
-4
edo888 at gmail dot com
14 years ago
[This] can solve 1053 issue.
You just need to add " if you have spaces in your path...

<?php
win32_create_service
(array(
       
'service' => 'COMPLAINTS',                 # the name of your service
       
'display' => 'Receive email complaints and direct them to the website', # description
       
'params' => '"' . __FILE__ . '"' . ' run', # path to the script and parameters
   
));
?>
To Top