array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'function.win32-set-service-status.php', 1 => 'win32_set_service_status', 2 => 'Update the service status', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'win32service Функції', ), 'prev' => array ( 0 => 'function.win32-set-service-pause-resume-state.php', 1 => 'win32_set_service_pause_resume_state', ), 'next' => array ( 0 => 'function.win32-start-service.php', 1 => 'win32_start_service', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/win32service/functions/win32-set-service-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_set_service_status

(PECL win32service >=0.1.0)

win32_set_service_status — Update the service status

Опис

win32_set_service_status(int $status, int $checkpoint = 0): void

Informs the SCM of the current status of a running service. This call is only valid for a running service process.

Застереження

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

Параметри

status

The service status code, one of WIN32_SERVICE_RUNNING, WIN32_SERVICE_STOPPED, WIN32_SERVICE_STOP_PENDING, WIN32_SERVICE_START_PENDING, WIN32_SERVICE_CONTINUE_PENDING, WIN32_SERVICE_PAUSE_PENDING, WIN32_SERVICE_PAUSED.

checkpoint

The checkpoint value the service increments periodically to report its progress during a lengthy start, stop, pause, or continue operation. For example, the service should increment this value as it completes each step of its initialization when it is starting up.

The checkpoint is only valid when the status is one of WIN32_SERVICE_STOP_PENDING, WIN32_SERVICE_START_PENDING, WIN32_SERVICE_CONTINUE_PENDING or WIN32_SERVICE_PAUSE_PENDING.

Значення, що повертаються

Не повертає значень.

Prior to version 1.0.0, повертається WIN32_NO_ERROR у разі успіху, false якщо виникли складнощі з параметрами, або Код помилки Win32 у разі збою.

Помилки/виключення

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

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

Журнал змін

Версія Опис
PECL win32service 1.0.0 Throws a ValueError on invalid data in parameters, previously false was returned.
PECL win32service 1.0.0 Throws a Win32ServiceException on error, previously a Win32 Error Code was returned.
PECL win32service 1.0.0 The return type is now void, previously it was mixed.
PECL win32service 0.2.0 This function works only in the "cli" SAPI.

Прогляньте також