win32service win32_get_last_control_message
(PECL win32service >=0.1.0)
win32_get_last_control_message — 이 서비스에 전송된 마지막 제어 메시지를 반환합니다.
설명
win32_get_last_control_message(): int
이 서비스 프로세스에 마지막으로 전송된 제어 코드를 반환합니다. 서비스로 실행할 때 서비스 실행을 중지해야 하는지 여부를 결정하기 위해 이를 주기적으로 확인해야 합니다.
주의 버전 0.2.0부터 이 함수는 "cli" SAPI에서만 작동합니다. 다른 SAPI에서는 이 함수는 비활성화됩니다.
매개변수
이 함수에는 매개변수가 없습니다.
반환 값
Win32Service Service Control Message Constants 중 하나가 될 제어 상수를 반환합니다.: WIN32_SERVICE_CONTROL_CONTINUE
, WIN32_SERVICE_CONTROL_DEVICEEVENT
, WIN32_SERVICE_CONTROL_HARDWAREPROFILECHANGE
, WIN32_SERVICE_CONTROL_INTERROGATE
, WIN32_SERVICE_CONTROL_NETBINDADD
, WIN32_SERVICE_CONTROL_NETBINDDISABLE
, WIN32_SERVICE_CONTROL_NETBINDENABLE
, WIN32_SERVICE_CONTROL_NETBINDREMOVE
, WIN32_SERVICE_CONTROL_PARAMCHANGE
, WIN32_SERVICE_CONTROL_PAUSE
, WIN32_SERVICE_CONTROL_POWEREVENT
, WIN32_SERVICE_CONTROL_PRESHUTDOWN
, WIN32_SERVICE_CONTROL_SESSIONCHANGE
, WIN32_SERVICE_CONTROL_SHUTDOWN
, WIN32_SERVICE_CONTROL_STOP
.
값이 128과 255 사이이면 제어 코드는 사용자 지정입니다.
오류/예외
버전 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 0.2.0 | 이 함수는 "cli" SAPI에서만 작동합니다. |
기타
- win32_start_service_ctrl_dispatcher() - 스크립트를 SCM에 등록하여 지정된 이름의 서비스로 작동할 수 있도록 합니다.
- win32_set_service_status() - 서비스 상태 업데이트
- win32_set_service_exit_mode() - 현재 실행 중인 서비스의 종료 모드를 정의하거나 반환합니다.
- win32_set_service_exit_code() - 현재 실행 중인 서비스에 대한 종료 코드 정의 또는 반환
- Win32Service 서비스 제어 메시지 상수