win32_query_service_status
(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 не указали.
