|  |  |  | polkit 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 pidpassed topolkit_unix_session_new_for_process()orNULLiferroris
set. Free withg_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 pidorNULLiferroris set. Free withg_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 bysession. | 
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. |