win32_stop_service
(PECL win32service >=0.1.0)
win32_stop_service — Останавливает службу
Описание
Останавливает обозначенную службу. Требует административных привилегий, либо аккаунта с соответствующим образом настроенным 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. |
Смотрите также
- win32_start_service() - Запускает службу
- win32_pause_service() - Приостанавливает службу
- win32_continue_service() - Возобновляет работу приостановленной службы
- win32_send_custom_control() - Отправляет настраиваемый элемент управления в службу
- Коды Ошибок Win32
add a note
