SecretAgentOldGetSecretsFunc


Description:

[ CCode ( instance_pos = 4.9 ) ]
public delegate void SecretAgentOldGetSecretsFunc (SecretAgentOld agent, Connection connection, Variant secrets, Error error)

Called as a result of a request by NM to retrieve secrets.

When the SecretAgentOld subclass has finished retrieving secrets and is ready to return them, or to return an error, this function should be called with those secrets or the error.

To easily create the dictionary to return the Wi-Fi PSK, you could do something like this: <example> <title>Creating a secrets dictionary</title> <programlisting> NMConnection *secrets; NMSettingWirelessSecurity *s_wsec; GVariant *secrets_dict;

secrets = nm_simple_connection_new (); s_wsec = (NMSettingWirelessSecurity *) nm_setting_wireless_security_new (); g_object_set ( G_OBJECT (s_wsec), NM_SETTING_WIRELESS_SECURITY_PSK, "my really cool PSK", NULL); nm_connection_add_setting (secrets, NM_SETTING ( s_wsec)); secrets_dict = nm_connection_to_dbus (secrets, NM_CONNECTION_SERIALIZE_ALL);

(call the NMSecretAgentOldGetSecretsFunc with secrets_dict)

g_object_unref (secrets); g_variant_unref (secrets_dict); </programlisting> </example>

Parameters:

agent

the secret agent object

connection

the connection for which secrets were requested, note that this object will be unrefed after the callback has returned, use @ref/g_object_unref() if you want to use this object after the callback has returned

secrets

the Variant of type nm_variant_type_connection containing the requested secrets (as created by to_dbus for example). Each key in secrets should be the name of a Setting object (like "802-11-wireless-security") and each value should be an nm_variant_type_setting variant. The sub-dicts map string:value, where the string is the setting property name (like "psk") and the value is the secret

error

if the secrets request failed, give a descriptive error here

user_data

caller-specific data to be passed to the function


Namespace: NM
Package: libnm



2022 vala-language.org