摘要
更換帳號代碼。
宣告
#include <zircon/syscalls.h>
zx_status_t zx_handle_replace(zx_handle_t handle,
zx_rights_t rights,
zx_handle_t* out);
說明
zx_handle_replace() 會建立「帳號代碼」替代項目，參照的相同基礎物件，並提供新的存取權限權利。
handle 一律會失效。
如果 rights 為 ZX_RIGHT_SAME_RIGHTS，則替換控點將具備與原始帳號代碼相同的權利。否則，權利必須是原始帳號代碼權利的子集。
權限
無。
傳回值
zx_handle_replace() 成功後會傳回 ZX_OK 和替換控制代碼 (透過「出」)。
錯誤
「ZX_ERR_BAD_HANDLE」的帳號代碼無效。
ZX_ERR_INVALID_ARGS 要求的權利並非「控制」的權限子集，或「out」為無效指標。
ZX_ERR_NO_MEMORY 因記憶體不足而失敗。使用者空間無法以任何方式處理這個錯誤 (極可能) 錯誤。日後的建構作業不會再發生這個錯誤。