win32_delete_serviceDeletes a service entry from the SCM database
&reftitle.description;
voidwin32_delete_servicestringservicenamestringmachine&null;
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.
&reftitle.parameters;
servicename
The short name of the service.
machine
The optional machine name. If omitted, the local machine will be used.
&reftitle.returnvalues;
&return.void;
Prior to version 1.0.0, &win32service.noerror.false.error;
&reftitle.errors;
A ValueError is thrown if the
value of servicename parameter is empty.
A Win32ServiceException is thrown on error.
&reftitle.changelog;
&Version;&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.
&reftitle.examples;
A win32_delete_service example
Deletes the dummyphp service.
]]>
&reftitle.seealso;
win32_create_serviceWin32 Error Codes