PolkitAuthorizationResult

PolkitAuthorizationResult — Result for checking an authorization

Stability Level

Stable, unless otherwise indicated

Synopsis

                    PolkitAuthorizationResult;
PolkitAuthorizationResult * polkit_authorization_result_new
                                                        (gboolean is_authorized,
                                                         gboolean is_challenge,
                                                         PolkitDetails *details);
gboolean            polkit_authorization_result_get_is_authorized
                                                        (PolkitAuthorizationResult *result);
gboolean            polkit_authorization_result_get_is_challenge
                                                        (PolkitAuthorizationResult *result);
gboolean            polkit_authorization_result_get_retains_authorization
                                                        (PolkitAuthorizationResult *result);
const gchar *       polkit_authorization_result_get_temporary_authorization_id
                                                        (PolkitAuthorizationResult *result);
gboolean            polkit_authorization_result_get_dismissed
                                                        (PolkitAuthorizationResult *result);
PolkitDetails *     polkit_authorization_result_get_details
                                                        (PolkitAuthorizationResult *result);

Object Hierarchy

  GObject
   +----PolkitAuthorizationResult

Description

This class represents the result you get when checking for an authorization.

Details

PolkitAuthorizationResult

typedef struct _PolkitAuthorizationResult PolkitAuthorizationResult;

The PolkitAuthorizationResult struct should not be accessed directly.


polkit_authorization_result_new ()

PolkitAuthorizationResult * polkit_authorization_result_new
                                                        (gboolean is_authorized,
                                                         gboolean is_challenge,
                                                         PolkitDetails *details);

Creates a new PolkitAuthorizationResult object.

is_authorized :

Whether the subject is authorized.

is_challenge :

Whether the subject is authorized if more information is provided. Must be FALSE unless is_authorized is TRUE.

details :

Must be NULL unless is_authorized is TRUE. [allow-none]

Returns :

A PolkitAuthorizationResult object. Free with g_object_unref().

polkit_authorization_result_get_is_authorized ()

gboolean            polkit_authorization_result_get_is_authorized
                                                        (PolkitAuthorizationResult *result);

Gets whether the subject is authorized.

If the authorization is temporary, use polkit_authorization_result_get_temporary_authorization_id() to get the opaque identifier for the temporary authorization.

result :

A PolkitAuthorizationResult.

Returns :

Whether the subject is authorized.

polkit_authorization_result_get_is_challenge ()

gboolean            polkit_authorization_result_get_is_challenge
                                                        (PolkitAuthorizationResult *result);

Gets whether the subject is authorized if more information is provided.

result :

A PolkitAuthorizationResult.

Returns :

Whether the subject is authorized if more information is provided.

polkit_authorization_result_get_retains_authorization ()

gboolean            polkit_authorization_result_get_retains_authorization
                                                        (PolkitAuthorizationResult *result);

Gets whether authorization is retained if obtained via authentication. This can only be the case if result indicates that the subject can obtain authorization after challenge (cf. polkit_authorization_result_get_is_challenge()), e.g. when the subject is not already authorized (cf. polkit_authorization_result_get_is_authorized()).

If the subject is already authorized, use polkit_authorization_result_get_temporary_authorization_id() to check if the authorization is temporary.

This method simply reads the value of the key/value pair in details with the key polkit.retains_authorization_after_challenge.

result :

A PolkitAuthorizationResult.

Returns :

TRUE if the authorization is or will be temporary.

polkit_authorization_result_get_temporary_authorization_id ()

const gchar *       polkit_authorization_result_get_temporary_authorization_id
                                                        (PolkitAuthorizationResult *result);

Gets the opaque temporary authorization id for result if result indicates the subject is authorized and the authorization is temporary rather than one-shot or permanent.

You can use this string together with the result from polkit_authority_enumerate_temporary_authorizations() to get more details about the temporary authorization or polkit_authority_revoke_temporary_authorization_by_id() to revoke the temporary authorization.

If the subject is not authorized, use polkit_authorization_result_get_retains_authorization() to check if the authorization will be retained if obtained via authentication.

This method simply reads the value of the key/value pair in details with the key polkit.temporary_authorization_id.

result :

A PolkitAuthorizationResult.

Returns :

The opaque temporary authorization id for result or NULL if not available. Do not free this string, it is owned by result. [allow-none]

polkit_authorization_result_get_dismissed ()

gboolean            polkit_authorization_result_get_dismissed
                                                        (PolkitAuthorizationResult *result);

Gets whether the authentication request was dismissed / canceled by the user.

This method simply reads the value of the key/value pair in details with the key polkit.dismissed.

result :

A PolkitAuthorizationResult.

Returns :

TRUE if the authentication request was dismissed, FALSE otherwise.

Since 0.101


polkit_authorization_result_get_details ()

PolkitDetails *     polkit_authorization_result_get_details
                                                        (PolkitAuthorizationResult *result);

Gets the details about the result.

result :

A PolkitAuthorizationResult.

Returns :

A PolkitDetails object or NULL if there are no details. This object is owned by result and should not be freed by the caller. [allow-none][transfer none]