invoke_credentials_required_sync

Let's the client-side know that credentials are required.

The reason defines which parameters are used. The client passed the credentials with an invoke_authenticate call.

The e_source_credentials_reason_required is used for the first credentials prompt, when the client can return credentials as stored from the previous success login.

The e_source_credentials_reason_rejected is used when the previously used credentials had been rejected by the server. That usually means that the user should be asked to provide/correct the credentials.

The e_source_credentials_reason_ssl_failed is used when a secured connection failed due to some server-side certificate issues.

The e_source_credentials_reason_error is used when the server returned an error. It is not possible to connect to it at the moment usually.

If an error occurs, the function sets throws and returns false.

Parameters:

this	an Source
reason	an SourceCredentialsReason, why the credentials are required
certificate_pem	PEM-encoded secure connection certificate, or an empty string
certificate_errors	a bit-or of TlsCertificateFlags for secure connection certificate
op_error	a Error with a description of the previous credentials error, or null
cancellable	optional Cancellable object, or null

Returns:

true on success, false on error