diff options
author | Thomas Haller <thaller@redhat.com> | 2015-09-03 10:22:29 +0200 |
---|---|---|
committer | Thomas Haller <thaller@redhat.com> | 2015-09-18 14:31:31 +0200 |
commit | afb37d706f2cf63ebc9b5b3f92dc7a0163f2dc1b (patch) | |
tree | 3b1b97b5f9c4f95f5d00c7e1e819b945ac9cbe24 | |
parent | 21fd5fa0ab45ef1651c0e062e6c84c6d692161fa (diff) | |
download | NetworkManager-afb37d706f2cf63ebc9b5b3f92dc7a0163f2dc1b.tar.gz |
secret-agent/trivial: add code comment
-rw-r--r-- | src/settings/nm-secret-agent.c | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/src/settings/nm-secret-agent.c b/src/settings/nm-secret-agent.c index d77f5e0e29..ca30d46211 100644 --- a/src/settings/nm-secret-agent.c +++ b/src/settings/nm-secret-agent.c @@ -446,6 +446,17 @@ do_cancel_secrets (NMSecretAgent *self, Request *r, gboolean disposing) } } +/** + * nm_secret_agent_cancel_secrets: + * @self: #NMSecretAgent instance + * @call_id: the call id to cancel + * + * It is an error to pass an invalid @call_id or a @call_id for an operation + * that already completed. NMSecretAgent will always invoke the callback, + * also for cancel() and dispose(). + * In case of nm_secret_agent_cancel_secrets() this will synchronously invoke the + * callback before nm_secret_agent_cancel_secrets() returns. + */ void nm_secret_agent_cancel_secrets (NMSecretAgent *self, NMSecretAgentCallId call_id) { |