摘要
更換帳號代碼。
宣告
#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 一律失效，
如果右為 ZX_RIGHT_SAME_RIGHTS，替換控點會
具備與原帳號代碼相同的權利。否則，就必須為權利
原始帳號代碼權利的子集。
權限
無。
傳回值
zx_handle_replace() 會傳回 ZX_OK 和取代控點 (透過傳出)
成功的關鍵
錯誤
ZX_ERR_BAD_HANDLE 帳號代碼不是有效的帳號代碼。
ZX_ERR_INVALID_ARGS 要求的權利並非子集
帳號代碼的權利或傳出是無效的指標。
ZX_ERR_NO_MEMORY 因記憶體不足而失敗。
使用者空間無法妥善處理這種 (異常) 錯誤。
在日後的版本中不會再發生這個錯誤。