(PECL win32service >=0.1.0)
win32_delete_service — Deletes a service entry from the SCM database
Attempts to delete a service from the SCM database. Administrative privilegues are required for this to succeed.
This function really just marcs the service for deletion. If other processses (such as the Services Applet) are open, then the deletion will be deferred until those applications are closed. If a service is marqued 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.
No value is returned.
Prior to versionen 1.0.0, returned
WIN32_NO_ERROR
on success,
false
if there is a problem with the parameters or a
Win32 Error Code
on failure.
A
ValueError
is thrown if the
value of
servicename
parameter is empty.
A Win32ServiceException is thrown on error.
| Versionen | Description |
|---|---|
| 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 . |
Example #1 A win32_delete_service() example
Deletes the dummyphp service.
<?php
win32_delete_service
(
'dummyphp'
);
?>