win32_start_service_ctrl_dispatcher

win32_start_service_ctrl_dispatcher

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

void **win32_start_service_ctrl_dispatcher** string $name bool $gracefulMode

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 with the constant. If you need to perform some lengthy process before the service is actually running, then you can use the 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 and handling the return code appropriately. win32_set_service_status``WIN32_SERVICE_RUNNING``WIN32_SERVICE_START_PENDING``win32_get_last_control_message

Let op: > Since version 0.2.0, this function work only in "cli" SAPI. On other SAPI this function is disabled.

name The short-name of the service, as registered by . win32_create_service

gracefulMode true for exit graceful. false for exit with error. See for more details. win32_set_service_exit_mode

return.void

Prior to version 1.0.0, win32service.noerror.false.error

Prior to version 1.0.0, if the SAPI is not , this function emits an level error. "cli"``E_ERROR

As of version 1.0.0, will throw a 
 if SAPI is not 

Win32ServiceException``"cli"

Voorbeeld: A 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
}
?>

win32_set_service_status``win32_get_last_control_message``win32_set_service_exit_mode``win32_set_service_exit_codeWin32 Error Codes