PHP Velho Oeste 2024

win32_start_service

(PECL win32service >=0.1.0)

win32_start_serviceЗапускает службу

Описание

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

Производит попытку запуска обозначенной службы. Обычно требует административных привилегий, либо аккаунта с соответствующим образом настроенным ACL для сервиса.

Список параметров

servicename

Короткое название службы.

machine

Необязательное имя машины. Если не указано, используется на локальной машине.

Возвращаемые значения

Функция не возвращает значения после выполнения.

До версии 1.0.0, Возвращает WIN32_NO_ERROR в случае успешного завершения , false если была обнаружена проблема с параметрами или код ошибки Win32 при неудачном завершении работы.

Ошибки

Выбрасывает ValueError, если значение параметра servicename не задано.

Выбрасывает Win32ServiceException в случае возникновения ошибки.

Список изменений

Версия Описание
PECL win32service 1.0.0 Выбрасывает ValueError при некорректных данных в параметрах, ранее возвращалось false.
PECL win32service 1.0.0 Выбрасывает Win32ServiceException в случае возникновения ошибки, ранее возвращался Код ошибки Win32.
PECL win32service 1.0.0 Тип возвращаемого значения void, ранее был mixed.
PECL win32service 0.3.0 Этой функции больше не требуется привилегии администратора, если для используемого пользователя корректно настроен ACL.

Смотрите также

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