| PolicyKit Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
PolkitUnixSession; PolkitSubject * polkit_unix_session_new (const gchar *session_id); void polkit_unix_session_new_for_process (gint pid,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); PolkitSubject * polkit_unix_session_new_for_process_finish (GAsyncResult *res,GError **error); PolkitSubject * polkit_unix_session_new_for_process_sync (gint pid,GCancellable *cancellable,GError **error); const gchar * polkit_unix_session_get_session_id (PolkitUnixSession *session); void polkit_unix_session_set_session_id (PolkitUnixSession *session,const gchar *session_id);
An object that represents an user session.
The session id is an opaque string obtained from ConsoleKit.
typedef struct _PolkitUnixSession PolkitUnixSession;
The PolkitUnixSession struct should not be accessed directly.
PolkitSubject * polkit_unix_session_new (const gchar *session_id);
Creates a new PolkitUnixSession for session_id.
|
The session id. |
Returns : |
A PolkitUnixSession. Free with g_object_unref(). [transfer full]
|
void polkit_unix_session_new_for_process (gint pid,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Asynchronously creates a new PolkitUnixSession object for the
process with process id pid.
When the operation is finished, callback will be invoked in the
polkit_unix_session_new_for_process_finish() to get the result of
the operation.
This method constructs the object asynchronously, for the synchronous and blocking version
use polkit_unix_session_new_for_process_sync().
|
The process id of the process to get the session for. |
|
A GCancellable or NULL. [allow-none]
|
|
A GAsyncReadyCallback to call when the request is satisfied |
|
The data to pass to callback. |
PolkitSubject * polkit_unix_session_new_for_process_finish (GAsyncResult *res,GError **error);
Finishes constructing a PolkitSubject for a process id.
|
A GAsyncResult obtained from the GAsyncReadyCallback passed to polkit_unix_session_new_for_process(). |
|
Return location for error. [allow-none] |
Returns : |
A PolkitUnixSession for the pid passed to
polkit_unix_session_new_for_process() or NULL if error is
set. Free with g_object_unref(). [transfer full][allow-none]
|
PolkitSubject * polkit_unix_session_new_for_process_sync (gint pid,GCancellable *cancellable,GError **error);
Creates a new PolkitUnixSession for the process with process id pid.
This is a synchronous call - the calling thread is blocked until a
reply is received. For the asynchronous version, see
polkit_unix_session_new_for_process().
|
The process id of the process to get the session for. |
|
A GCancellable or NULL. [allow-none]
|
|
Return location for error. [allow-none] |
Returns : |
A PolkitUnixSession for
pid or NULL if error is set. Free with g_object_unref(). [allow-none][transfer full]
|
const gchar * polkit_unix_session_get_session_id (PolkitUnixSession *session);
Gets the session id for session.
|
A PolkitUnixSession. |
Returns : |
The session id for session. Do not free this string, it
is owned by session. |
void polkit_unix_session_set_session_id (PolkitUnixSession *session,const gchar *session_id);
Sets the session id for session to session_id.
|
A PolkitUnixSession. |
|
The session id. |