Scholar Repository
Home>Manual>Registers the script with the SCM, so that it can act as the service with the given name

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


win32_start_service_ctrl_dispatcher

(PECL win32service SVN)

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

Description

mixed win32_start_service_ctrl_dispatcher ( string $name )

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 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() and handling the return code appropriately.

Parameters

name

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

Return Values

Returns TRUE on success, otherwise FALSE or a win32 error code.

Examples

Example #1 A win32_start_service_ctrl_dispatcher() 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");
}

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


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