win32service 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 Service Type Bitmasks를 참조하십시오.
CurrentState- dwCurrentState. Win32Service Service Status Constants를 참조하십시오.
ControlsAccepted- 서비스에서 허용하는 서비스 제어. Win32Service Service Control Message Accepted Bitmasks를 참조하십시오.
Win32ExitCode- 서비스가 종료된 경우 프로세스의 반환 코드입니다. 종료 모드가 정상이 아닌 경우 이 값은
WIN32_ERROR_SERVICE_SPECIFIC_ERROR와 같습니다. Win32Service error codes 및 win32_set_service_exit_mode() 참조 ServiceSpecificExitCode- 서비스가 오류 조건과 함께 종료된 경우 이벤트 로그에 기록된 서비스 특정 코드가 여기에 표시됩니다. 이 값은 win32_set_service_exit_code()에 의해 정의된 값과 같습니다.
CheckPoint- 서비스가 종료되는 경우 현재 체크 포인트 번호를 유지합니다. 이것은 SCM에서 일종의 하트 비트로 사용되어 쐐기형 서비스 프로세스를 감지합니다. 체크 포인트의 값은 WaitHint 값과 함께 가장 잘 해석됩니다.
WaitHint- 서비스가 종료되면 WaitHint를 100% 완료를 나타내는 체크포인트 값으로 설정합니다. 진행률 표시기를 구현하는 데 사용할 수 있습니다.
ProcessId- Windows 프로세스 식별자입니다. 0이면 프로세스가 실행되고 있지 않습니다.
ServiceFlags- dwServiceFlags. Win32Service Service Flag Constants를 참조하십시오.
오류/예외
servicename 매개변수의 값이 비어 있으면 ValueError가 발생합니다.
변경 로그
| 버전 | 설명 |
|---|---|
| PECL win32service 1.0.0 | 매개변수의 잘못된 데이터에 대해 ValueError를 발생시킵니다. 이전에는 false가 반환되었습니다. |
| PECL win32service 1.0.0 | 이전에 Win32 Error Code가 반환된 오류 시 Win32ServiceException을 throw합니다. |
| PECL win32service 1.0.0 | 반환 유형은 이제 void이며 이전에는 mixed되었습니다. |