win32service win32_set_service_status
(PECL win32service >=0.1.0)
win32_set_service_status — 서비스 상태 업데이트
설명
win32_set_service_status(int $status, int $checkpoint = 0): void
실행 중인 서비스의 현재 상태를 SCM에 알립니다. 이 호출은 실행 중인 서비스 프로세스에만 유효합니다.
주의 버전 0.2.0부터 이 함수는 "cli" SAPI에서만 작동합니다. 다른 SAPI에서는 이 함수는 비활성화됩니다.
매개변수
status- 서비스 상태 코드는
WIN32_SERVICE_RUNNING,WIN32_SERVICE_STOPPED,WIN32_SERVICE_STOP_PENDING,WIN32_SERVICE_START_PENDING,WIN32_SERVICE_CONTINUE_PENDING,WIN32_SERVICE_PAUSE_PENDING,WIN32_SERVICE_PAUSED중 하나입니다. checkpoint- 긴 시작, 중지, 일시 중지 또는 계속 작업 중에 진행 상황을 보고하기 위해 서비스가 주기적으로 증가하는 체크포인트 값입니다. 예를 들어 서비스는 시작될 때 초기화의 각 단계를 완료할 때 이 값을 증가시켜야 합니다.
checkpoint는status가WIN32_SERVICE_STOP_PENDING,WIN32_SERVICE_START_PENDING,WIN32_SERVICE_CONTINUE_PENDING또는WIN32_SERVICE_PAUSE_PENDING중 하나일 때만 유효합니다.
반환 값
값이 반환되지 않습니다.
버전 1.0.0 이전에는 성공 시 WIN32_NO_ERROR를, 매개변수에 문제가 있으면 false를, 실패 시 Win32 Error Code를 반환했습니다.
오류/예외
버전 1.0.0 이전에는 SAPI가 "cli"가 아니면 이 함수는 E_ERROR 레벨 오류를 내보냅니다.
버전 1.0.0부터 SAPI가 "cli"가 아닌 경우 Win32ServiceException이 발생합니다.
변경 로그
| 버전 | 설명 |
|---|---|
| PECL win32service 1.0.0 | 매개변수의 잘못된 데이터에 대해 ValueError를 발생시킵니다. 이전에는 false가 반환되었습니다. |
| PECL win32service 1.0.0 | 이전에 Win32 Error Code가 반환된 오류 시 Win32ServiceException을 throw합니다. |
| PECL win32service 1.0.0 | 반환 유형은 이제 void이며 이전에는 mixed되었습니다. |
| PECL win32service 0.2.0 | 이 함수는 "cli" SAPI에서만 작동합니다. |
기타
- win32_start_service_ctrl_dispatcher() - 스크립트를 SCM에 등록하여 지정된 이름의 서비스로 작동할 수 있도록 합니다.
- win32_get_last_control_message() - 이 서비스에 전송된 마지막 제어 메시지를 반환합니다.
- win32_set_service_exit_mode() - 현재 실행 중인 서비스의 종료 모드를 정의하거나 반환합니다.
- win32_set_service_exit_code() - 현재 실행 중인 서비스에 대한 종료 코드 정의 또는 반환
- Win32Service 서비스 상태 상수