(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。 |