CakeFest 2024: The Official CakePHP Conference

win32_delete_service

(PECL win32service >=0.1.0)

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

Описание

win32_delete_service(string $servicename, string $machine = ?): 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');
?>

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

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top