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

기타