array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.win32-query-service-status.php', 1 => 'win32_query_service_status', 2 => 'Запрашивает статус службы', ), 'up' => array ( 0 => 'ref.win32service.php', 1 => 'win32service', ), 'prev' => array ( 0 => 'function.win32-pause-service.php', 1 => 'win32_pause_service', ), 'next' => array ( 0 => 'function.win32-read-all-rights-access-service.php', 1 => 'win32_read_all_rights_access_service', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/win32service/functions/win32-query-service-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

win32_query_service_status

(PECL win32service >=0.1.0)

win32_query_service_status — Запрашивает статус службы

Описание

win32_query_service_status(string $servicename, string $machine = null): array

Функция запрашивает текущий статус службы и возвращает массив информации.

Список параметров

servicename

Краткое название службы.

machine

Необязательное имя машины. Функция работает с локальной машиной, если параметр не установили.

Возвращаемые значения

В случае успешного выполнения функция возвращает массив, который состоит из следующей информации:

До версии 1.0.0 , false, если возникла проблема с параметрами, или код ошибки Win32, если возникла ошибка.

ServiceType

Тип dwServiceType. Смотрите Битовые маски типов службы Win32Service.

CurrentState

Тип dwCurrentState. Смотрите Константы состояния службы Win32Service.

ControlsAccepted

Какие элементы управления службами принимаются службой. Смотрите Битовые маски принятых управляющих сообщений службы Win32Service.

Win32ExitCode

Код возврата из процесса, если служба завершила работу. Это значение равно WIN32_ERROR_SERVICE_SPECIFIC_ERROR, если режим выхода не плавный. Смотрите коды ошибок Win32Service и описание функции win32_set_service_exit_mode().

ServiceSpecificExitCode

Код конкретной службы, который ОС зарегистрировала в журнале событий при завершении работы службы. Это значение равно значению, которое определили функцией win32_set_service_exit_code()

CheckPoint

Текущий номер контрольной точки, если служба завершила работу. Значением пользуется БС SCM как сердцебиением, чтобы обнаружить заклинивание процесса обслуживания. Значение контрольной точки лучше всего интерпретировать вместе со значением WaitHint.

WaitHint

Служба установит для WaitHint значение контрольной точки, которое будет указывать на 100 % завершение, если служба завершила работу. Значением пользуются для реализации индикатора прогресса.

ProcessId

Идентификатор процесса Windows. Для незапущенных процессов значение параметра равняется 0.

ServiceFlags

Тип dwServiceFlags. Смотрите Константы флагов службы Win32Service.

Ошибки

Функция выбрасывает исключение ValueError, если значение параметра servicename не указали.

Список изменений

Версия Описание
PECL win32service 1.0.0 Функция выбрасывает исключение ValueError при недопустимых данных в параметрах, раньше возвращалось false.
PECL win32service 1.0.0 Функция выбрасывает исключение Win32ServiceException, если возникла ошибка, раньше возвращался Код ошибки Win32.
PECL win32service 1.0.0 Тип возврата теперь array, раньше был mixed.

Смотрите также