Skip to main content

HandleAvailability

Enum HandleAvailability 

Source
#[repr(i32)]
pub enum HandleAvailability { Unspecified = 0, Available = 1, Held = 2, Taken = 3, Reserved = 4, Confusable = 5, }
Expand description

Availability of a native handle after normalization and classification. RESERVED represents an explicit policy reservation; implementations MUST NOT infer it merely because a name is otherwise unavailable.

Variants§

§

Unspecified = 0

No usable classification was produced. The caller may retry the safe GetHandleStatus read; it MUST NOT infer that a mutation is allowed.

§

Available = 1

No other-owner hold, active native handle, or confusable collision blocks this caller. held_for_verified_owner = false means a genuinely free name: a new account claims it through BeginWebAuthnRegistration followed by RegisterPublicKey. held_for_verified_owner = true means the caller may own the nonblocking verified-owner hold; ClaimHandle is the authoritative self-claim check.

§

Held = 2

A verified-owner hold for another subject blocks this caller. The only mutation offered to the caller is RequestHeldName, which starts the right-of-first-refusal window without exposing the owner.

§

Taken = 3

An active native handle already owns this name. ResolveHandle can read the public subject-free projection; no claim or escrow mutation is available.

§

Reserved = 4

Explicit policy reservation. No handle mutation is available for this candidate; choose another candidate and call GetHandleStatus again.

§

Confusable = 5

The candidate conflicts with a trust-bearing handle under the confusable classifier, so no free-name registration mutation is available; choose another candidate and call GetHandleStatus again. ClaimHandle remains only for a previously earned caller-owned verified-owner hold and is the authoritative check for that hidden ownership fact.

Implementations§

Source§

impl HandleAvailability

Source

pub const fn is_valid(value: i32) -> bool

Returns true if value is a variant of HandleAvailability.

Source

pub fn from_i32(value: i32) -> Option<HandleAvailability>

👎Deprecated:

Use the TryFrom<i32> implementation instead

Converts an i32 to a HandleAvailability, or None if value is not a valid variant.

Source§

impl HandleAvailability

Source

pub fn as_str_name(&self) -> &'static str

String value of the enum field names used in the ProtoBuf definition.

The values are not transformed in any way and thus are considered stable (if the ProtoBuf definition does not change) and safe for programmatic use.

Source

pub fn from_str_name(value: &str) -> Option<Self>

Creates an enum from field names used in the ProtoBuf definition.

Trait Implementations§

Source§

impl Clone for HandleAvailability

Source§

fn clone(&self) -> HandleAvailability

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Copy for HandleAvailability

Source§

impl Debug for HandleAvailability

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for HandleAvailability

Source§

fn default() -> HandleAvailability

Returns the “default value” for a type. Read more
Source§

impl Eq for HandleAvailability

Source§

impl From<HandleAvailability> for i32

Source§

fn from(value: HandleAvailability) -> i32

Converts to this type from the input type.
Source§

impl Hash for HandleAvailability

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl Ord for HandleAvailability

Source§

fn cmp(&self, other: &HandleAvailability) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 (const: unstable) · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 (const: unstable) · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 (const: unstable) · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

impl PartialEq for HandleAvailability

Source§

fn eq(&self, other: &HandleAvailability) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl PartialOrd for HandleAvailability

Source§

fn partial_cmp(&self, other: &HandleAvailability) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 (const: unstable) · Source§

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 (const: unstable) · Source§

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 (const: unstable) · Source§

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 (const: unstable) · Source§

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl StructuralPartialEq for HandleAvailability

Source§

impl TryFrom<i32> for HandleAvailability

Source§

type Error = UnknownEnumValue

The type returned in the event of a conversion error.
Source§

fn try_from(value: i32) -> Result<HandleAvailability, UnknownEnumValue>

Performs the conversion.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.