win32_stop_service

(PECL win32service >=0.1.0)

win32_stop_serviceОстанавливает службу

Описание

win32_stop_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.

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