Struct ClientControllerProxy

pub struct ClientControllerProxy { /* private fields */ }

Implementations

impl ClientControllerProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.wlan.policy/ClientController.

pub fn take_event_stream(&self) -> ClientControllerEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn start_client_connections( &self, ) -> QueryResponseFut<RequestStatus, DefaultFuchsiaResourceDialect>

Enables WLAN client functionality. Once enabled, automatic connections will be attempted for saved networks, and callers can initiate operations via the ScanForNetworks() and Connect() APIs. Depending on the underlying capabilities of the device, this call may impact other device operation (for example, acting as an access point). The returned status represents acknowledgement of the request. The ClientListener protocol should be monitored to learn when client functionality has been enabled.

pub fn stop_client_connections( &self, ) -> QueryResponseFut<RequestStatus, DefaultFuchsiaResourceDialect>

Tears down any existing connections to wlan networks and disables initiation of new connections. The returned status represents acknowledgements of the request. The ClientListener protocol should be monitored to learn when client functionality has been disabled.

pub fn scan_for_networks( &self, iterator: ServerEnd<ScanResultIteratorMarker>, ) -> Result<(), Error>

Triggers a network scan. Note, even in normal operation, some scan requests may be rejected due to timing with connection establishment or other critical connection maintenance. If the scan is cancelled or errors, the caller is notified via a status update in the ScanResultIterator. In the current implementation, client connections must be started for a scan to be performed.

pub fn save_network( &self, config: &NetworkConfig, ) -> QueryResponseFut<ClientControllerSaveNetworkResult, DefaultFuchsiaResourceDialect>

Saves a network and any credential information needed to connect. Multiple entries for the same NetworkIdentifier can exist if the credentials are different. If a caller attempts to save a NetworkConfig with the same NetworkIdentifier and same Credentials as a previously saved network the method will effectively be a no-op. Saved networks will be used to autoconnect, and are also available to use with the Connect() API.

pub fn remove_network( &self, config: &NetworkConfig, ) -> QueryResponseFut<ClientControllerRemoveNetworkResult, DefaultFuchsiaResourceDialect>

Removes a saved network configuration, if one exists. This method will automatically trigger a disconnection if the NetworkConfig was used to establish the connection.

pub fn get_saved_networks( &self, iterator: ServerEnd<NetworkConfigIteratorMarker>, ) -> Result<(), Error>

Retrieve the currently saved networks using the provided iterator.

pub fn connect( &self, id: &NetworkIdentifier, ) -> QueryResponseFut<RequestStatus, DefaultFuchsiaResourceDialect>

Request to attempt a connection to the specified network. The target of the connect call must already be a saved network. This call is not a blocking call for the duration of the connection attempt. If the call cannot be immediately attempted, a failure status will be returned. If the connection request will be attempted, an acknowledgment status will be returned. Updates to the connection status are disseminated via the ClientStateUpdates protocol. If the connect attempt fails, the service will fall back to default behavior with scanning and connecting via network selection.

Trait Implementations

impl ClientControllerProxyInterface for ClientControllerProxy

type StartClientConnectionsResponseFut = QueryResponseFut<RequestStatus>

type StopClientConnectionsResponseFut = QueryResponseFut<RequestStatus>

type SaveNetworkResponseFut = QueryResponseFut<Result<(), NetworkConfigChangeError>>

type RemoveNetworkResponseFut = QueryResponseFut<Result<(), NetworkConfigChangeError>>

type ConnectResponseFut = QueryResponseFut<RequestStatus>

fn start_client_connections(&self) -> Self::StartClientConnectionsResponseFut

fn stop_client_connections(&self) -> Self::StopClientConnectionsResponseFut

fn scan_for_networks( &self, iterator: ServerEnd<ScanResultIteratorMarker>, ) -> Result<(), Error>

fn save_network(&self, config: &NetworkConfig) -> Self::SaveNetworkResponseFut

fn remove_network( &self, config: &NetworkConfig, ) -> Self::RemoveNetworkResponseFut

fn get_saved_networks( &self, iterator: ServerEnd<NetworkConfigIteratorMarker>, ) -> Result<(), Error>

fn connect(&self, id: &NetworkIdentifier) -> Self::ConnectResponseFut

impl Clone for ClientControllerProxy

fn clone(&self) -> ClientControllerProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ClientControllerProxy

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

Formats the value using the given formatter.

impl Proxy for ClientControllerProxy

type Protocol = ClientControllerMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.