Trait HandleBased
pub trait HandleBased:
AsHandleRef
+ From<NullableHandle>
+ Into<NullableHandle> {
// Provided methods
fn duplicate_handle(&self, rights: Rights) -> Result<Self, Status> { ... }
fn replace_handle(self, rights: Rights) -> Result<Self, Status> { ... }
fn into_handle(self) -> NullableHandle { ... }
fn into_raw(self) -> u32 { ... }
}Expand description
A trait implemented by all handle-based types.
Note: it is reasonable for user-defined objects wrapping a handle to implement
this trait. For example, a specific interface in some protocol might be
represented as a newtype of Channel, and implement the as_handle_ref
method and the From<Handle> trait to facilitate conversion from and to the
interface.
Provided Methods§
fn duplicate_handle(&self, rights: Rights) -> Result<Self, Status>
fn duplicate_handle(&self, rights: Rights) -> Result<Self, Status>
Duplicate a handle, possibly reducing the rights available. Wraps the zx_handle_duplicate syscall.
fn replace_handle(self, rights: Rights) -> Result<Self, Status>
fn replace_handle(self, rights: Rights) -> Result<Self, Status>
Create a replacement for a handle, possibly reducing the rights available. This invalidates the original handle. Wraps the zx_handle_replace syscall.
fn into_handle(self) -> NullableHandle
fn into_handle(self) -> NullableHandle
Converts the value into its inner handle.
This is a convenience function which simply forwards to the Into trait.
Dyn Compatibility§
This trait is not dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.