Dutch PHP Conference 2021 - Call for Papers

win32_delete_service

(PECL win32service >=0.1.0)

win32_delete_serviceDeletes a service entry from the SCM database

Описание

win32_delete_service ( string $servicename , string $machine = ? ) : void

Attempts to delete a service from the SCM database. Administrative privileges are required for this to succeed.

This function really just marks the service for deletion. If other processes (such as the Services Applet) are open, then the deletion will be deferred until those applications are closed. If a service is marked for deletion, further attempts to delete it will fail, and attempts to create a new service with that name will also fail.

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

servicename

The short name of the service.

machine

The optional machine name. If omitted, the local machine will be used.

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

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

Prior to version 1.0.0, Возвращает WIN32_NO_ERROR в случае успешного завершения , false если была обнаружена проблема с параметрами или код ошибки Win32 при неудачном завершении работы.

Ошибки

A ValueError is thrown if the; value of servicename parameter is empty.

A Win32ServiceException is thrown on error.

Примеры

Пример #1 A win32_delete_service() example

Deletes the dummyphp service.

<?php
win32_delete_service
('dummyphp');
?>

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

Версия Описание
PECL win32service 1.0.0 Throws a ValueError on invalid data in parameters, previously false was returned.
PECL win32service 1.0.0 Throws a Win32ServiceException on error, previously a Win32 Error Code was returned.
PECL win32service 1.0.0 The return type is now void, previously it was mixed.

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

add a note add a note

User Contributed Notes

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