win32_start_service_ctrl_dispatcher

(PECL win32service >=0.1.0)

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

说明

win32_start_service_ctrl_dispatcher ( string $name [, bool $gracefulMode = true ] ) : mixed

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

Caution

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 win32_set_service_exit_mode() for more details.

返回值

成功时返回 TRUE，参数错误时返回 FALSE，或失败时返回一个 Win32 错误码。

错误／异常

If SAPI is not "cli", this function emits an E_ERROR level error.

范例

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");
}

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
}
?>

更新日志

版本 说明
0.4.0 The parameter gracefulMode has been added.
0.2.0 This function works only in the "cli" SAPI.

参见

相关文章
php windows 专用扩展 win32servicephp dbx 函数 escape a string so it can safely be used in an sql statementphp eio 函数 delete a name and possibly the file it refers tophp mcve 函数 returns array of strings which represents the keys that can be used for response parameters on this transactionphp win32service 函数 resumes a paused servicephp win32service 函数 creates a new service entry in the scm databasephp win32service 函数 deletes a service entry from the scm databasephp win32service 函数 returns the last control message that was sent to this servicephp win32service 函数 pauses a servicephp win32service 函数 queries the status of a servicephp win32service 函数 send a custom control to the servicephp win32service 函数 define or return the exit code for the current running servicephp win32service 函数 define or return the exit mode for the current running servicephp win32service 函数 update the service statusphp win32service 函数 registers the script with the scm so that it can act as the service with the given namephp win32service 函数 starts a servicephp win32service 函数 stops a servicephp win32ps win32ps 函数php win32service win32service 函数php 预定义常量 win32service service type bitmasks
关注编程学问公众号