Удаляет запись службы из базы данных SCM

# win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_service — Удаляет запись службы из базы данных SCM

### Описание

function win32_delete_service(string `$servicename`, string `$machine` = `null`): void

Функция пытается удалить службу из базы данных SCM. Для этого требуются права администратора.

Функция на самом деле просто помечает сервис для удаления. Если другие процессы (например, сервисный апплет) открыли, то функция отложит удаление до закрытия этих приложений. Очередные попытки удаления службы не завершатся ошибкой, если службу пометили для удаления, а попытки создать новую службу с этим именем также завершатся неудачей.

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

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

### Примеры

Пример #1 Пример использования функции win32_delete_service()

Удаляет службу dummyphp.

    <?php

    win32_delete_service('dummyphp');

    ?>

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

- win32_create_service() - Создаёт новую запись службы в базе данных SCM
- Коды ошибок Win32

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