摘要
終止提供的工作或程序。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_task_kill(zx_handle_t handle);
說明
這會以非同步方式終止指定程序或工作及其子項。 直到位於 handle 的整個工作樹狀結構都死了。 不支援終止執行緒。
可以等待工作透過 ZX_TASK_TERMINATED
失效
網路。依信號觀察到的程序完成後,工作並
所有子項都會被視為處於死亡狀態,且在大多數的情況下
就無法繼續成功
如果 handle 是工作,且 syscall 成功,則工作無法再 建立新的程序
當系統透過此 sys 呼叫 終止程序或工作時,return_code
會
ZX_TASK_RETCODE_SYSCALL_KILL
:zx_object_get_info()
透過
ZX_INFO_PROCESS
或 ZX_INFO_JOB
主題。
處理程序和工作也可被其他代理程式刪除,例如工作政策
ZX_POL_ACTION_KILL
或系統記憶體不足 OOM 時。
權限
handle 必須包含 ZX_RIGHT_DESTROY
。
傳回值
成功時,zx_task_kill()
會傳回 ZX_OK
。如果程序使用
終止自身的系統呼叫,此系統呼叫不會傳回
錯誤
ZX_ERR_BAD_HANDLE
帳號代碼不是有效的帳號代碼。
ZX_ERR_WRONG_TYPE
處理常式不是工作控制代碼。
ZX_ERR_ACCESS_DENIED
處理常式沒有 ZX_RIGHT_DESTROY
沒錯
ZX_ERR_NOT_SUPPORTED
「處理常式」是執行緒處理常式。