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

# win32_query_service_status

(PECL win32service >=0.1.0)

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

### Описание

function 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.

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

- Предопределённые константы Win32Service

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open