polkit_authorization_result_new ()

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

Creates a new PolkitAuthorizationResult object.

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.

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.

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.

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.

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.

Since: 0.101

polkit_authorization_result_get_details ()

PolkitDetails *
polkit_authorization_result_get_details
                               (PolkitAuthorizationResult *result);

Gets the details about the result.

PolkitAuthorizationResult

typedef struct _PolkitAuthorizationResult PolkitAuthorizationResult;

The PolkitAuthorizationResult struct should not be accessed directly.