Method

EDataServerSourceinvoke_authenticate

since: 3.16

Declaration [src]

void
e_source_invoke_authenticate (
  ESource* source,
  const ENamedParameters* credentials,
  GCancellable* cancellable,
  GAsyncReadyCallback callback,
  gpointer user_data
)

Description [src]

Asynchronously calls the InvokeAuthenticate method on the server side, thus the backend knows what credentials to use to connect to its (possibly remote) data store.

When the operation is finished, callback will be called. You can then call e_source_invoke_authenticate_finish() to get the result of the operation.

Available since: 3.16

This method completes asynchronously. Use e_source_invoke_authenticate_finish() inside the GAsyncReadyCallback to obtain the result of the operation.

Parameters

credentials

Type: ENamedParameters

An ENamedParameters structure with credentials to use; can be NULL to use those from the last call.

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.
callback

Type: GAsyncReadyCallback

A GAsyncReadyCallback to call when the request is satisfied.

The argument can be NULL.
user_data

Type: gpointer

Data to pass to the callback function.

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