win32_query_service_status(3) [php man page]

WIN32_QUERY_SERVICE_STATUS(3)						 1					     WIN32_QUERY_SERVICE_STATUS(3)

win32_query_service_status - Queries the status of a service

SYNOPSIS

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

DESCRIPTION

	Queries the current status for a service, returning an array of information.

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 an array consisting of the following information on success, FALSE if there is a problem with the parameters or a Win32 Error Code
       on failure.

	      o $ServiceType
		- The dwServiceType. See Win32Service Service Type Bitmasks.

	      o $CurrentState
		- The dwCurrentState. See Win32Service Service Status Constants.

	      o $ControlsAccepted
		- Which service controls are accepted by the service. See Win32Service Service Control Message Accepted Bitmasks.

	      o $Win32ExitCode
		- If the service exited, the return code from the process.

	      o $ServiceSpecificExitCode
		- If the service exited with an error condition, the service specific code that is logged in the event log is visible here.

	      o $CheckPoint
		- If the service is shutting down, holds the current check point number. This is used by the SCM as a kind of heart-beat to detect
		a wedged service process. The value of the check point is best interpreted in conjunction with the WaitHint value.

	      o $WaitHint
		-  If the service is shutting down it will set WaitHint to a checkpoint value that will indicate 100% completion. This can be used
		to implement a progress indicator.

	      o $ProcessId
		- The Windows process identifier. If 0, the process is not running.

	      o $ServiceFlags
		- The dwServiceFlags. See Win32Service Service Service Flag Constants.

SEE ALSO

       Win32Service Predefined Constants.

PHP Documentation Group 											     WIN32_QUERY_SERVICE_STATUS(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)