Method

EBackendBackendschedule_credentials_required

since: 3.16

Declaration [src] 

void
e_backend_schedule_credentials_required (
  EBackend* backend,
  ESourceCredentialsReason reason,
  const gchar* certificate_pem,
  GTlsCertificateFlags certificate_errors,
  const GError* op_error,
  GCancellable* cancellable,
  const gchar* who_calls
)

Description [src]

Asynchronously invokes e_backend_credentials_required(), but installs its own callback which only prints a runtime warning on the console when the call fails. The who_calls is a prefix of the console message. This is useful when the caller just wants to start the operation without having actual place where to show the operation result.

See the note about sources authenticating with OAuth2 in e_backend_credentials_required_sync(): for them, prefer e_backend_schedule_authenticate(), because a credentials-required always ends in an interactive prompt.

Available since: 3.16

Parameters

reason

Type: ESourceCredentialsReason

An ESourceCredentialsReason, why the credentials are required.

certificate_pem

Type: const gchar*

PEM-encoded secure connection certificate, or an empty string.

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
certificate_errors

Type: GTlsCertificateFlags

A bit-or of GTlsCertificateFlags for secure connection certificate.

op_error

Type: GError

A GError with a description of the previous credentials error, or NULL.

The argument can be NULL.
The data is owned by the caller of the method.
cancellable

Type: GCancellable

Optional GCancellable object, or NULL.

The argument can be NULL.
The data is owned by the caller of the method.
who_calls

Type: const gchar*

An identification who calls this.

The argument can be NULL.
The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.