zx_restricted_kick

摘要

將執行緒退出受限模式。

宣告

#include <zircon/syscalls-next.h>

zx_status_t zx_restricted_kick(zx_handle_t thread, uint32_t options);

說明

如果執行緒目前在受限模式下執行,就會退出受限模式 或在沒有答案的情況下儲存擱置段落。如果目標執行緒正在執行 進入受限模式後,系統會透過提供給 zx_restricted_enter,原因代碼已設為 ZX_RESTRICTED_REASON_KICK。 否則下次呼叫 zx_restricted_enter 時不會進入受限模式 而是會改以合理方式發送到提供的進入點 代碼 ZX_RESTRICTED_REASON_KICK

同一個執行緒物件的多個啟動次數會收合在一起。因此,如果 多個執行緒會在處於相同目標時呼叫 zx_restricted_kick 執行或進入嚴格篩選模式,至少一個模式 系統會觀察 ZX_RESTRICTED_REASON_KICK 的退貨情形。建議使用的 首先要記錄 並呼叫 zx_restricted_kick。執行緒呼叫 每當 zx_restricted_enter 觀察到這個資料結構時,都應參考這個資料結構 ZX_RESTRICTED_REASON_KICK並處理任何待處理狀態,再重新進入 嚴格篩選模式。

options 必須為零。

權限

ZX_RIGHT_MANAGE_THREAD 是「Thread」的必要項目。

錯誤

ZX_ERR_INVALID_ARGS options 為 0 以外的任何值。 ZX_ERR_WRONG_TYPE 執行緒不是執行緒。 ZX_ERR_ACCESS_DENIED 執行緒沒有 ZX_RIGHT_MANAGE_THREAD。 ZX_ERR_BAD_STATE thread 已失效。