Zx-handle_replace

摘要

更換帳號代碼。

宣告

#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 因記憶體不足而失敗。 使用者空間無法妥善處理這種 (異常) 錯誤。 在日後的版本中不會再發生這個錯誤。

另請參閱