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
긴 시작, 중지, 일시 중지 또는 계속 작업 중에 진행 상황을 보고하기 위해 서비스가 주기적으로 증가하는 체크포인트 값입니다. 예를 들어 서비스는 시작될 때 초기화의 각 단계를 완료할 때 이 값을 증가시켜야 합니다.

checkpointstatusWIN32_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에서만 작동합니다.

기타