win32_query_service_status
(PECL win32service >=0.1.0)
win32_query_service_status — Запитує статус сервісу
Опис
win32_query_service_status(string $servicename, string $machine = ?): array
Вимагає поточний статус служби, повертаючи масив інформації.
Список параметрів
servicename
Коротка назва служби.
machine
Необов'язкове ім'я машини. Якщо не вказано, використовуватиметься локальний комп'ютер.
Значення, що повертаються
Повертає масив, що складається з наступної інформації у разі успішного виконання:
До версії 1.0.0 false якщо була виявлена проблема з параметрами або код помилки Win32 при невдалому завершенні роботи.
ServiceType
dwServiceType. СмотритеПобутові маски типів служби Win32Service
CurrentState
dwCurrentState. СмотритеКонстанти стану служби Win32Service
ControlsAccepted
Які елементи керування службами приймаються службою. Дивіться Побутові маски Win32Service Service Control Message Accepted
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 |