### Class

# EDataServerUI CredentialsPrompterImpl

since: 3.16

#### Description [src]

    abstract class EDataServerUI.CredentialsPrompterImpl : EDataServer.Extension
    {
      ECredentialsPrompterImplPrivate* priv
    }

Credentials prompter implementation base structure. The descendants implement ECredentialsPrompterImpl::prompt(), which is used to prompt for credentials. The descendants are automatically registered into an `ECredentialsPrompter`.

Available since: 3.16

#### Hierarchy

#### Ancestors

- EExtension
- GObject

#### Descendants

- ECredentialsPrompterImplOAuth2
- ECredentialsPrompterImplPassword

#### Instance methods

###### e_credentials_prompter_impl_cancel_prompt

Asks the `prompt_impl` to cancel current prompt, which should have ID `prompt_id`.

since: 3.16

###### e_credentials_prompter_impl_get_credentials_prompter

Returns an `ECredentialsPrompter` with which the `prompter_impl` is associated.

since: 3.16

###### e_credentials_prompter_impl_prompt

Runs a credentials prompt for the `prompter_impl`. The actual prompter implementation receives the prompt through ECredentialsPrompterImplClass::process_prompt(), where the given `prompt_id` is used for an identification. The prompt is left ‘active’ as long as it is not finished with a call of e_credentials_prompter_impl_prompt_finish(). This should be called even for cancelled prompts. The prompt can be cancelled before it’s processed, using the e_credentials_prompter_impl_cancel_prompt().

since: 3.16

###### e_credentials_prompter_impl_prompt_finish

The actual credentials prompt implementation finishes a previously started credentials prompt `prompt_id` with ECredentialsPrompterImplClass::process_prompt() by a call to this function. This function should be called regardless the prompt was or was not cancelled with e_credentials_prompter_impl_cancel_prompt(). Once the prompt is finished another queued is started, if any pending exists. Use `NULL` `credentials` for cancelled prompts, otherwise the credentials are used for authentication of the associated `ESource`.

since: 3.16

##### Methods inherited from EExtension (1)

###### e_extension_get_extensible

Returns the object that `extension` extends.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

##### Properties inherited from EExtension (1)

###### EDataServer.Extension:extensible

The object being extended.

#### Signals

###### EDataServerUI.CredentialsPrompterImpl::prompt-finished

Emitted when a prompt of ID `prompt_id` is finished.

since: 3.16

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct EDataServerUICredentialsPrompterImplClass {
      EExtensionClass parent_class;
      const gchar* const* authentication_methods;
      void (* process_prompt) (
        ECredentialsPrompterImpl* prompter_impl,
        gpointer prompt_id,
        ESource* auth_source,
        ESource* cred_source,
        const gchar* error_text,
        const ENamedParameters* credentials
      );
      void (* cancel_prompt) (
        ECredentialsPrompterImpl* prompter_impl,
        gpointer prompt_id
      );
      void (* prompt_finished) (
        ECredentialsPrompterImpl* prompter_impl,
        gpointer prompt_id,
        const ENamedParameters* credentials
      );

    }

No description available.

###### Class members

`parent_class: EExtensionClass`

  No description available.

`authentication_methods: const gchar* const*`

  No description available.

`process_prompt: void (* process_prompt) ( ECredentialsPrompterImpl* prompter_impl, gpointer prompt_id, ESource* auth_source, ESource* cred_source, const gchar* error_text, const ENamedParameters* credentials )`

  No description available.

`cancel_prompt: void (* cancel_prompt) ( ECredentialsPrompterImpl* prompter_impl, gpointer prompt_id )`

  No description available.

`prompt_finished: void (* prompt_finished) ( ECredentialsPrompterImpl* prompter_impl, gpointer prompt_id, const ENamedParameters* credentials )`

  No description available.

#### Virtual methods

###### EDataServerUI.CredentialsPrompterImplClass.cancel_prompt

Asks the `prompt_impl` to cancel current prompt, which should have ID `prompt_id`.

since: 3.16

###### EDataServerUI.CredentialsPrompterImplClass.process_prompt

No description available.

###### EDataServerUI.CredentialsPrompterImplClass.prompt_finished

No description available.