Struct NetworkEntry 

pub struct NetworkEntry<'a> {
    pub hidden: bool,
    pub raw_key: bool,
    pub security: SecurityMode,
    pub ssid: &'a [u8],
    pub credential: &'a [u8],
}

One entry of PROP_WIFI_NETWORKS: a network the device knows.

Secret-bearing. The reported form stops at the SSID, which is what Self::encode_reported writes and what Self::decode yields from a device’s answer, with credential empty.

Fields

hidden: bool

The network hides its SSID.

raw_key: bool

credential is a raw pairwise master key rather than a passphrase.

security: SecurityMode

ssid: &'a [u8]

1 to SSID_MAX_LEN octets. Never empty: an empty selection means no selection, so an entry with no name could be stored and never chosen.

credential: &'a [u8]

Empty in the reported form, and for the modes that take none.

Implementations

impl<'a> NetworkEntry<'a>

pub const fn flags(&self) -> u8

The flags octet for this entry.

pub fn validate(&self) -> Result<(), WifiError>

Whether this entry is one a device may be asked to store.

Separate from encoding so that a host can check itself before transmitting and a device can apply the same rule to what arrives, answering STATUS_INVALID_ARGUMENT to anything this rejects. A mode that is well-formed but beyond the hardware is a different answer, STATUS_UNIMPLEMENTED, and is not decided here.

pub fn encode(&self, out: &mut [u8]) -> Result<usize, WifiError>

Encode the item form, credential included.

pub fn encode_reported(&self, out: &mut [u8]) -> Result<usize, WifiError>

Encode the reported form: the item through its SSID. No CMD_PROP_GET and no notification ever carries a credential.

pub fn decode(bytes: &'a [u8]) -> Result<Self, WifiError>

Decode one item. The credential is whatever follows the SSID, which is empty in a reported entry.

Trait Implementations

impl<'a> Clone for NetworkEntry<'a>

fn clone(&self) -> NetworkEntry<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for NetworkEntry<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for NetworkEntry<'a>

fn eq(&self, other: &NetworkEntry<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

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

impl<'a> Copy for NetworkEntry<'a>

impl<'a> Eq for NetworkEntry<'a>

impl<'a> StructuralPartialEq for NetworkEntry<'a>