win32_get_last_control_message(3) [php man page]

WIN32_GET_LAST_CONTROL_MESSAGE(3)					 1					 WIN32_GET_LAST_CONTROL_MESSAGE(3)

win32_get_last_control_message - Returns the last control message that was sent to this service

SYNOPSIS

       int win32_get_last_control_message (void  )

DESCRIPTION

	Returns  the  control  code  that  was	last sent to this service process. When running as a service you should periodically check this to
       determine if your service needs to stop running.

RETURN VALUES

	Returns a control constant which will be one of  the  Win32Service  Service  Control  Message  Constants:  WIN32_SERVICE_CONTROL_CONTINUE,
       WIN32_SERVICE_CONTROL_INTERROGATE,    WIN32_SERVICE_CONTROL_PAUSE,    WIN32_SERVICE_CONTROL_PRESHUTDOWN,    WIN32_SERVICE_CONTROL_SHUTDOWN,
       WIN32_SERVICE_CONTROL_STOP.

SEE ALSO

       win32_start_service_ctrl_dispatcher(3), Win32Service Service Control Message Constants.

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