![]() |
![]() |
![]() |
libnm-glib Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals |
NMRemoteConnection; NMRemoteConnectionClass; void (*NMRemoteConnectionCommitFunc) (NMRemoteConnection *connection
,GError *error
,gpointer user_data
); void (*NMRemoteConnectionDeleteFunc) (NMRemoteConnection *connection
,GError *error
,gpointer user_data
); void (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection
,GHashTable *secrets
,GError *error
,gpointer user_data
); #define NM_REMOTE_CONNECTION_REMOVED #define NM_REMOTE_CONNECTION_UPDATED void nm_remote_connection_commit_changes (NMRemoteConnection *connection
,NMRemoteConnectionCommitFunc callback
,gpointer user_data
); void nm_remote_connection_delete (NMRemoteConnection *connection
,NMRemoteConnectionDeleteFunc callback
,gpointer user_data
); void nm_remote_connection_get_secrets (NMRemoteConnection *connection
,const char *setting_name
,NMRemoteConnectionGetSecretsFunc callback
,gpointer user_data
); NMRemoteConnection * nm_remote_connection_new (DBusGConnection *bus
,const char *path
);
"bus" DBusGConnection* : Write / Construct Only "dbus-connection" DBusGConnection* : Write / Construct Only "dbus-path" gchar* : Write / Construct Only
typedef struct { NMConnectionClass parent_class; /* Signals */ void (*updated) (NMRemoteConnection *connection, GHashTable *new_settings); void (*removed) (NMRemoteConnection *connection); /* Padding for future expansion */ void (*_reserved1) (void); void (*_reserved2) (void); void (*_reserved3) (void); void (*_reserved4) (void); void (*_reserved5) (void); void (*_reserved6) (void); } NMRemoteConnectionClass;
void (*NMRemoteConnectionCommitFunc) (NMRemoteConnection *connection
,GError *error
,gpointer user_data
);
Called when NetworkManager has committed outstanding changes to a connection
to backing storage as a result of nm_remote_connection_commit_changes()
.
|
the connection for which updates are to be committed |
|
on failure, a descriptive error |
|
user data passed to nm_remote_connection_commit_changes()
|
void (*NMRemoteConnectionDeleteFunc) (NMRemoteConnection *connection
,GError *error
,gpointer user_data
);
Called when NetworkManager has deleted a connection as a result of
nm_remote_connection_delete()
.
|
the connection to be deleted |
|
on failure, a descriptive error |
|
user data passed to nm_remote_connection_delete()
|
void (*NMRemoteConnectionGetSecretsFunc) (NMRemoteConnection *connection
,GHashTable *secrets
,GError *error
,gpointer user_data
);
Called when NetworkManager returns secrets in response to a request for
secrets via nm_remote_connection_get_secrets()
.
|
the connection for which secrets were requested |
|
on success, a hash table of hash tables, with each inner hash mapping a setting property to a GValue containing that property's value. [element-type utf8 GLib.HashTable] |
|
on failure, a descriptive error |
|
user data passed to nm_remote_connection_get_secrets()
|
void nm_remote_connection_commit_changes (NMRemoteConnection *connection
,NMRemoteConnectionCommitFunc callback
,gpointer user_data
);
Save any local changes to the settings and properties of this connection and save them in the settings service.
|
the NMRemoteConnection |
|
a function to be called when the commit completes. [scope async][allow-none] |
|
caller-specific data to be passed to callback . [closure]
|
void nm_remote_connection_delete (NMRemoteConnection *connection
,NMRemoteConnectionDeleteFunc callback
,gpointer user_data
);
Delete the connection.
|
the NMRemoteConnection |
|
a function to be called when the delete completes. [scope async][allow-none] |
|
caller-specific data to be passed to callback . [closure]
|
void nm_remote_connection_get_secrets (NMRemoteConnection *connection
,const char *setting_name
,NMRemoteConnectionGetSecretsFunc callback
,gpointer user_data
);
Request the connection's secrets.
|
the NMRemoteConnection |
|
the NMSetting object name to get secrets for |
|
a function to be called when the update completes;
must not be NULL . [scope async]
|
|
caller-specific data to be passed to callback . [closure]
|
NMRemoteConnection * nm_remote_connection_new (DBusGConnection *bus
,const char *path
);
Creates a new object representing the remote connection.
|
a valid and connected D-Bus connection |
|
the D-Bus path of the connection as exported by the settings service |
Returns : |
the new remote connection object on success, or NULL on failure |
"dbus-connection"
property "dbus-connection" DBusGConnection* : Write / Construct Only
DBusGConnection.
"dbus-path"
property"dbus-path" gchar* : Write / Construct Only
DBus Object Path.
Default value: NULL
"removed"
signalvoid user_function (NMRemoteConnection *connection,
gpointer user_data) : Run First
This signal is emitted when a connection is either deleted or becomes invisible to the current user.
|
a NMConnection |
|
user data set when the signal handler was connected. |
"updated"
signalvoid user_function (NMRemoteConnection *connection,
gpointer user_data) : Run First
This signal is emitted when a connection changes, and it is still visible to the user.
|
a NMConnection |
|
user data set when the signal handler was connected. |
"visible"
signalvoid user_function (NMRemoteConnection *nmremoteconnection,
gboolean arg1,
gpointer user_data) : Run First
|
the object which received the signal. |
|
user data set when the signal handler was connected. |