(PECL win32service >=0.1.0)
win32_get_last_control_message — 返回发送到此服务的最后一个控制消息
返回最后发送到此服务进程的控制代码。在作为服务运行时,您应该定期检查此项以确定您的服务是否需要停止运行。
从版本 0.2.0 开始,此函数仅在 "cli" SAPI 中有效。在其他 SAPI 上,此函数被禁用。
此函数没有参数。
返回一个控制常量,它将是 Win32Service 服务控制消息常量 之一: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 | 在出错时抛出 Win32ServiceException,之前返回 Win32 错误代码。 |
PECL win32service 0.2.0 | 此函数仅在 "cli" SAPI 中有效。 |