win32_delete_service(3) [php man page]

WIN32_DELETE_SERVICE(3) 						 1						   WIN32_DELETE_SERVICE(3)

win32_delete_service - Deletes a service entry from the SCM database

SYNOPSIS

       mixed win32_delete_service (string  $servicename, [string  $machine])

DESCRIPTION

	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

	      o $servicename
		- The short name of the service.

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

RETURN VALUES

	Returns WIN32_NO_ERROR on success, FALSE if there is a problem with the parameters or a Win32 Error Code on failure.

EXAMPLES

       Example #1

	      A win32_delete_service(3) example

	       Deletes the dummyphp service.

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

SEE ALSO

       win32_create_service(3), Win32 Error Codes.

PHP Documentation Group 												   WIN32_DELETE_SERVICE(3)

WIN32_START_SERVICE_CTRL_DISPATCHER(3)					 1				    WIN32_START_SERVICE_CTRL_DISPATCHER(3)

win32_start_service_ctrl_dispatcher - Registers the script with the SCM, so that it can act as the service with the given name

SYNOPSIS

       mixed win32_start_service_ctrl_dispatcher (string  $name)

DESCRIPTION

	When  launched	via  the  Service Control Manager, a service process is required to "check-in" with it to establish service monitoring and
       communication facilities. This function performs the check-in by spawning a thread to handle the lower-level communication with the service
       control manager.

	Once  started,	the service process should do 2 things. The first is to tell the Service Control Manager that the service is running. This
       is achieved by calling win32_set_service_status(3) with the WIN32_SERVICE_RUNNING constant. If you need to  perform  some  lengthy  process
       before  the  service  is actually running, then you can use the WIN32_SERVICE_START_PENDING constant. The second is to continue to check-in
       with the service  control  manager  so  that  it  can  determine  if  it  should  terminate.  This  is  achieved  by  periodically  calling
       win32_get_last_control_message(3) and handling the return code appropriately.

PARAMETERS

	      o $name
		- The short-name of the service, as registered by win32_create_service(3).

RETURN VALUES

	Returns TRUE on success, FALSE if there is a problem with the parameters or a Win32 Error Code on failure.

EXAMPLES

       Example #1

	      A win32_start_service_ctrl_dispatcher(3) example

	       Check if the service is runnig under the SCM.

	      <?php
	      if (!win32_start_service_ctrl_dispatcher('dummyphp')) {
		die("I'm probably not running under the service control manager");
	      }

	      win32_set_service_status(WIN32_SERVICE_START_PENDING);

	      // Some lengthy process to get this service up and running.

	      win32_set_service_status(WIN32_SERVICE_RUNNING);

	      while (WIN32_SERVICE_CONTROL_STOP != win32_get_last_control_message()) {
		# do some work here, trying not to take more than around 30 seconds
		# before coming back into the loop again
	      }
	      ?>

SEE ALSO

       win32_set_service_status(3), win32_get_last_control_message(3), Win32 Error Codes.

PHP Documentation Group 										    WIN32_START_SERVICE_CTRL_DISPATCHER(3)