zx_task_kill

摘要

終止提供的工作或程序。

宣告

#include <zircon/syscalls.h>

zx_status_t zx_task_kill(zx_handle_t handle);

說明

這會以非同步方式終止指定程序或工作及其子項。 直到位於 handle 的整個工作樹狀結構都死了。 不支援終止執行緒。

可以等待工作透過 ZX_TASK_TERMINATED 失效 網路。依信號觀察到的程序完成後,工作並 所有子項都會被視為處於死亡狀態,且在大多數的情況下 就無法繼續成功

如果 handle 是工作,且 syscall 成功,則工作無法再 建立新的程序

當系統透過此 sys 呼叫 終止程序或工作時,return_codeZX_TASK_RETCODE_SYSCALL_KILLzx_object_get_info()透過 ZX_INFO_PROCESSZX_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「處理常式」是執行緒處理常式。

另請參閱