win32service win32_set_service_exit_mode
(PECL win32service >=0.4.0)
win32_set_service_exit_mode — 현재 실행 중인 서비스의 종료 모드를 정의하거나 반환합니다.
설명
win32_set_service_exit_mode(bool $gracefulMode
= true
): bool
GracefulMode
매개변수가 제공되면 종료 모드가 변경됩니다. 종료 모드가 정상이 아닌 경우 사용되는 종료 코드는 win32_set_service_exit_code() 함수로 설정할 수 있습니다.
주의 이 함수는 "cli" SAPI에서만 작동합니다. 다른 SAPI에서는 이 함수는 비활성화됩니다.
매개변수
gracefulMode
- 우아한 종료에 대해
true
입니다. 오류가 있는 종료의 경우false
입니다.
반환 값
현재 또는 이전 종료 모드를 반환합니다.
오류/예외
버전 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합니다. |
기타
- win32_start_service_ctrl_dispatcher() - 스크립트를 SCM에 등록하여 지정된 이름의 서비스로 작동할 수 있도록 합니다.
- win32_set_service_status() - 서비스 상태 업데이트
- win32_set_service_exit_code() - 현재 실행 중인 서비스에 대한 종료 코드 정의 또는 반환