Enum wnf::StateLifetime

#[repr(u8)]
pub enum StateLifetime {
    WellKnown = 0,
    Permanent = 1,
    Persistent = 2,
    Temporary = 3,
}

The lifetime of a state

This property of a state controls at what point in time it is automatically deleted as well as if and how it is persisted.

Variants

WellKnown = 0

Lifetime of a well-known state

A state with this lifetime cannot be created or deleted through the WNF API, but instead is provisioned with the system. It lives forever.

It is persisted in the Windows registry under the key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Notifications

Permanent = 1

Lifetime of a permanent state

A state with this lifetime can be created and deleted through the WNF API at any time and is never deleted automatically.

Creating a state with this lifetime requires the SeCreatePermanentPrivilege privilege.

It is persisted in the Windows registry under the key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Notifications

Persistent = 2

Lifetime of a persistent state (also known as volatile)

A state with this lifetime can be created and deleted through the WNF API at any time and is automatically deleted on system reboot.

Creating a state with this lifetime requires the SeCreatePermanentPrivilege privilege.

The name “persistent” is meant in relation to a temporary state name because it is persisted beyond the lifetime of the process it was created from. The alternative name “volatile” is meant in relation to a permanent state name because it is deleted on system reboot.

It is persisted in the Windows registry under the key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\VolatileNotifications

Temporary = 3

Lifetime of a temporary state

A state with this lifetime can be created and deleted through the WNF API at any time and is automatically deleted when the process it was created from exits.

It is not persisted in the Windows registry.

Trait Implementations

impl Clone for StateLifetime

fn clone(&self) -> StateLifetime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for StateLifetime

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

Formats the value using the given formatter.

impl From<CreatableStateLifetime> for StateLifetime

fn from(lifetime: CreatableStateLifetime) -> Self

Converts to this type from the input type.

impl FromPrimitive for StateLifetime

fn from_i64(n: i64) -> Option<Self>

Converts an i64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u64(n: u64) -> Option<Self>

Converts an u64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_isize(n: isize) -> Option<Self>

Converts an isize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i8(n: i8) -> Option<Self>

Converts an i8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i16(n: i16) -> Option<Self>

Converts an i16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i32(n: i32) -> Option<Self>

Converts an i32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i128(n: i128) -> Option<Self>

Converts an i128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_usize(n: usize) -> Option<Self>

Converts a usize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u8(n: u8) -> Option<Self>

Converts an u8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u16(n: u16) -> Option<Self>

Converts an u16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u32(n: u32) -> Option<Self>

Converts an u32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u128(n: u128) -> Option<Self>

Converts an u128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f32(n: f32) -> Option<Self>

Converts a f32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f64(n: f64) -> Option<Self>

Converts a f64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

impl Hash for StateLifetime

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for StateLifetime

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for StateLifetime

impl Eq for StateLifetime

impl StructuralPartialEq for StateLifetime