Top | ![]() |
![]() |
![]() |
![]() |
GIcon * | icon | Read |
GTlsInteraction * | interaction | Read / Write |
gchar * | label | Read |
gchar * | uri | Read |
An interface which allows importing of certificates and keys. Each GcrImporter is registered with a set of PKCS#11 attributes to match stuff that it can import.
An importer gets passed a GcrParser and accesses the currently parsed
item. To create a set of importers that can import the currently parsed
item in a GcrParser, use gcr_importer_create_for_parsed()
. The list of
importers returned has the parsed item queued for import.
To queue additional items with a importer use gcr_importer_queue_for_parsed()
.
In addition you can try and queue an additional item with a set of importers
using the gcr_importer_queue_and_filter_for_parsed()
.
To start the import use gcr_importer_import()
or the async variants.
GTlsInteraction *
gcr_importer_get_interaction (GcrImporter *importer
);
Get the interaction used to prompt the user when needed by this importer.
void gcr_importer_set_interaction (GcrImporter *importer
,GTlsInteraction *interaction
);
Set the interaction used to prompt the user when needed by this importer.
gboolean gcr_importer_import (GcrImporter *importer
,GCancellable *cancellable
,GError **error
);
Import the queued items in the importer. This call will block until the operation completes.
importer |
the importer |
|
cancellable |
a GCancellable, or |
|
error |
the location to place an error on failure, or |
void gcr_importer_import_async (GcrImporter *importer
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Import the queued items in the importer. This function returns immediately and completes asynchronously.
importer |
the importer |
|
cancellable |
a GCancellable, or |
|
callback |
called when the operation completes |
|
user_data |
data to be passed to the callback |
gboolean gcr_importer_import_finish (GcrImporter *importer
,GAsyncResult *result
,GError **error
);
Complete an asynchronous operation to import queued items.
importer |
the importer |
|
result |
an asynchronous result |
|
error |
the location to place an error on failure, or |
void gcr_importer_register (GType importer_type
,GckAttributes *attrs
);
Register an importer to handle parsed items that match the given attributes.
If attrs
are a floating reference, then it is consumed.
void
gcr_importer_register_well_known (void
);
Register built-in PKCS#11 and GnuPG importers.
GList *
gcr_importer_create_for_parsed (GcrParsed *parsed
);
Create a set of importers which can import this parsed item. The parsed item is represented by the state of the GcrParser at the time of calling this method.
a list of importers
which can import the parsed item, which should be freed with
g_object_unref()
, or NULL
if no types of importers can be created.
[element-type Gcr.Importer][transfer full]
gboolean gcr_importer_queue_for_parsed (GcrImporter *importer
,GcrParsed *parsed
);
Queues an additional item to be imported. The parsed item is represented by the state of the GcrParser at the time of calling this method.
If the parsed item is incompatible with the importer, then this will fail and the item will not be queued.
GList * gcr_importer_queue_and_filter_for_parsed (GList *importers
,GcrParsed *parsed
);
Queues an additional item to be imported in all compattible importers in the set. The parsed item is represented by the state of the GcrParser at the time of calling this method.
If the parsed item is incompatible with an importer, then that the item will not be queued on that importer.
struct GcrImporterIface { GTypeInterface parent; GList * (*create_for_parsed) (GcrParsed *parsed); gboolean (*queue_for_parsed) (GcrImporter *importer, GcrParsed *parsed); gboolean (*import_sync) (GcrImporter *importer, GCancellable *cancellable, GError **error); void (*import_async) (GcrImporter *importer, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gboolean (*import_finish) (GcrImporter *importer, GAsyncResult *result, GError **error); };
Interface implemented for a GcrImporter.
GTypeInterface |
parent interface |
|
implementation of |
||
implementation of |
||
optional implemantionon of |
||
implementation of |
||
implementation of |
“interaction”
property“interaction” GTlsInteraction *
The interaction for the importer.
Flags: Read / Write
“uri”
property“uri” gchar *
The URI of the location imported to.
Flags: Read
Default value: NULL