Delicious Bookmark this on Delicious Share on Facebook SlashdotSlashdot It! Digg! Digg



PHP : Function Reference : win32service Functions : win32_delete_service

win32_delete_service

Deletes a service entry from the SCM database ()
int win32_delete_service ( string servicename [, string machine] )

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.

Parameters

servicename

The short name of the service.

machine

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

Return Values

Returns TRUE on success, or a win32 error code on failure.

Examples

Example 2621. A win32_delete_service() example

Deletes the dummyphp service.

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


Code Examples / Notes » win32_delete_service

patrick crocker

The manual states that this function "Returns TRUE on success", however, I have found that this function returns WIN32_NO_ERROR  (zero) on success.
Environment as tested:
----------------------
Windows XP SP2
PHP 5.1.4
PECL php_win32service.dll 5.1.2


Change Language


Follow Navioo On Twitter
win32_create_service
win32_delete_service
win32_get_last_control_message
win32_query_service_status
win32_set_service_status
win32_start_service_ctrl_dispatcher
win32_start_service
win32_stop_service
eXTReMe Tracker