Function

Secretpassword_lookup_sync

unstable since: 1

Declaration [src]

gchar*
secret_password_lookup_sync (
  const SecretSchema* schema,
  GCancellable* cancellable,
  GError** error,
  ...
)

Description [src]

Lookup a password in the secret service.

The variable argument list should contain pairs of a) The attribute name as a null-terminated string, followed by b) attribute value, either a character string, an int number, or a gboolean value, as defined in the password schema. The list of attributes should be terminated with a NULL.

If no secret is found then NULL is returned.

This method may block indefinitely and should not be used in user interface threads.

Available since: 1

This function is not directly available to language bindings.

The implementation of this method is provided by secret_password_lookupv_sync() in language bindings

Parameters

schema

Type: SecretSchema

The schema for the attributes.

The data is owned by the caller of the function.
cancellable

Type: GCancellable

Optional cancellation object.

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

Type: GError

Location to place an error on failure.

The data is owned by the caller of the function.
...

Type: 

The attribute keys and values, terminated with NULL.

Return value

Type: gchar*

A new password string which should be freed with secret_password_free() or may be freed with g_free() when done.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.