Отправляет настраиваемый элемент управления в службу

# win32_send_custom_control

(PECL win32service >=0.4.0)

win32_send_custom_control — Отправляет настраиваемый элемент управления в службу

### Описание

function win32_send_custom_control(string `$servicename`, int `$control`, string `$machine` = `null`): void

Дополнительные сведения даёт » описание функции Microsoft ControlService.

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

`servicename`

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

`control`

  Значение настраиваемого элемента управления от 128 до 255.

`machine`

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

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

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

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

### Ошибки

До версии 1.0.0 функция выдавала ошибку уровня `E_ERROR`, если значение control находилось за пределами значений между 128 и 255.

Функция выбрасывает исключение ValueError, если значение параметра `servicename` не указали.

Функция выбрасывает исключение ValueError, если значение параметра `control` выходит за пределы значений между 128 и 255.

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

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

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

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

- win32_start_service() - Запускает службу
- win32_stop_service() - Останавливает службу
- win32_pause_service() - Приостанавливает службу
- win32_continue_service() - Возобновляет работу приостановленной службы
- Коды ошибок Win32

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