(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 中有效。 |