array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.win32-delete-service.php', 1 => 'win32_delete_service', 2 => 'Удаляет запись службы из базы данных SCM', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'win32service', ), 'prev' => array ( 0 => 'function.win32-create-service.php', 1 => 'win32_create_service', ), 'next' => array ( 0 => 'function.win32-get-last-control-message.php', 1 => 'win32_get_last_control_message', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/win32service/functions/win32-delete-service.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_delete_service

(PECL win32service >=0.1.0)

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

Описание

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');

?>

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