摘要
將執行緒退出受限模式。
宣告
#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 已失效。