Определяет или возвращает режим выхода для текущей запущенной службы

# win32_set_service_exit_mode

(PECL win32service >=0.4.0)

win32_set_service_exit_mode — Определяет или возвращает режим выхода для текущей запущенной службы

### Описание

function win32_set_service_exit_mode(bool `$gracefulMode` = true): bool

Функция изменяет режим выхода, если установили параметр `gracefulMode`. При недопустимом режиме выхода код выхода устанавливают функцией win32_set_service_exit_code().

Предостережение

Функция работает только через SAPI-интерфейс CLI. Через другие SAPI-интерфейсы функция не работает.

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

`gracefulMode`

  Значение `true` указывают для изящного выхода, а значение `false` для выхода с ошибкой.

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

Возвращает текущий или старый режим выхода.

### Ошибки

До версии 1.0.0 функция выдавала ошибку уровня `E_ERROR`, если вызывалась не через SAPI-интерфейс `"cli"`.

Начиная с версии 1.0.0 функция выбрасывает исключение Win32ServiceException при вызове не через SAPI-интерфейс `"cli"`.

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

Версия | Описание
--- | ---
PECL win32service 1.0.0 | Функция выбрасывает исключение ValueError при недопустимых данных в параметрах, раньше возвращалось `false`.
PECL win32service 1.0.0 | Функция выбрасывает исключение Win32ServiceException, если возникла ошибка, раньше возвращался код ошибки Win32.

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

- win32_start_service_ctrl_dispatcher() - Регистрирует скрипт в Диспетчере управления службами, чтобы он действовал как служба с заданным именем
- win32_set_service_status() - Обновляет статус службы
- win32_set_service_exit_code() - Определяет или возвращает код выхода для текущей запущенной службы

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open