![]() |
![]() |
![]() |
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() .
|
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
thread-default
main loop of the thread you are calling this method
from. You can then call
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 : |
allow-none. 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 : |
allow-none. allow-none. |
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. |