(PECL win32service >=0.1.0)
win32_query_service_status — Запрашивает статус службы
Функция запрашивает текущий статус службы и возвращает массив информации.
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. |