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