Function

Secretpassword_lookup_sync

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.

This function is not directly available to language bindings

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

Parameters

`schema`	`SecretSchema`
	The schema for the attributes.
	The data is owned by the caller of the function.
`cancellable`	`GCancellable`
	Optional cancellation object.
	The argument can be `NULL`.
	The data is owned by the caller of the function.
`error`	`GError`
	Location to place an error on failure.
	The data is owned by the caller of the function.
`...`
	The attribute keys and values, terminated with `NULL`.

Return value

Returns:	`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.