add_connection_async


Description:

public async RemoteConnection add_connection_async (Connection connection, bool save_to_disk, Cancellable? cancellable) throws Error

Requests that the remote settings service add the given settings to a new connection.

If save_to_disk is true, the connection is immediately written to disk; otherwise it is initially only stored in memory, but may be saved later by calling the connection's commit_changes method.

connection is untouched by this function and only serves as a template of the settings to add. The RemoteConnection object that represents what NetworkManager actually added is returned to callback when the addition operation is complete.

Note that the RemoteConnection returned in callback may not contain identical settings to connection as NetworkManager may perform automatic completion and/or normalization of connection properties.

Parameters:

this

the nmclient

connection

the connection to add. Note that this object's settings will be added, not the object itself

save_to_disk

whether to immediately save the connection to disk

cancellable

a Cancellable, or null

callback

callback to be called when the add operation completes

user_data

caller-specific data passed to callback