Function
SecretServiceopen_sync
Declaration [src]
SecretService*
secret_service_open_sync (
GType service_gtype,
const gchar* service_bus_name,
SecretServiceFlags flags,
GCancellable* cancellable,
GError** error
)
Description [src]
Create a new SecretService proxy for the Secret Service.
This function is rarely used, see secret_service_get_sync() instead.
The service_gtype argument should be set to SECRET_TYPE_SERVICE or a the
type of a derived class.
If flags contains any flags of which parts of the secret service to
ensure are initialized, then those will be initialized before returning.
If service_bus_name is NULL then the default is used.
This method may block indefinitely and should not be used in user interface threads.
Parameters
service_gtype-
Type:
GTypeThe GType of the new secret service.
service_bus_name-
Type:
const gchar*The D-Bus service name of the secret service.
The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. flags-
Type:
SecretServiceFlagsFlags for which service functionality to ensure is initialized.
cancellable-
Type:
GCancellableOptional cancellation object.
The argument can be NULL.The data is owned by the caller of the function. error-
Type:
GError **The return location for a recoverable error.
The argument can be NULL.If the return location is not NULL, then you must initialize it to aNULLGError*.The argument will left initialized to NULLby the function if there are no errors.In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.
Return value
Type: SecretService
A new reference to a SecretService proxy, which
should be released with g_object_unref().
| The caller of the function takes ownership of the data, and is responsible for freeing it. |