|  |  |  | Gcr Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
struct GcrImporter; struct GcrImporterClass; enum GcrImporterPromptBehavior; GcrImporter * gcr_importer_new (void); void gcr_importer_listen (GcrImporter *self,GcrParser *parser); void gcr_importer_queue (GcrImporter *self,const gchar *label,GckAttributes *attrs); gboolean gcr_importer_import (GcrImporter *self,GCancellable *cancellable,GError **error); void gcr_importer_import_async (GcrImporter *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); gboolean gcr_importer_import_finish (GcrImporter *self,GAsyncResult *result,GError **error); GckSlot * gcr_importer_get_slot (GcrImporter *self); void gcr_importer_set_slot (GcrImporter *self,GckSlot *slot); GcrImporterPromptBehavior gcr_importer_get_prompt_behavior (GcrImporter *self); void gcr_importer_set_prompt_behavior (GcrImporter *self,GcrImporterPromptBehavior behavior); GcrParser * gcr_importer_get_parser (GcrImporter *self); void gcr_importer_set_parser (GcrImporter *self,GcrParser *parser);
A GcrImporter can be used to import items into PKCS#11 slots. It's most
often used to parse the objects parsed with a GcrParser. Use
gcr_importer_listen() to hook up the importer to the parser.
Items are queued, and then imported with gcr_importer_import() or
gcr_importer_import_async().
struct GcrImporterClass {
	GObjectClass parent_class;
	/* signals */
	void (*queued) (GcrImporter *self, const gchar *label, GckAttributes *attrs);
	void (*imported) (GcrImporter *self, GckObject *object);
};
The class for GcrImporter.
| GObjectClass  | The parent class | 
| Signal which is fired when an item is queued | |
| Signal which is fired when an item is imported | 
typedef enum {
	GCR_IMPORTER_PROMPT_NEEDED,
	GCR_IMPORTER_PROMPT_ALWAYS,
	GCR_IMPORTER_PROMPT_NEVER
} GcrImporterPromptBehavior;
Flags for the prompting behavior of GcrImporter.
GcrImporter *       gcr_importer_new                    (void);
Create a new GcrImporter.
| Returns : | A newly allocated importer, which should be released with g_object_unref(). | 
void gcr_importer_listen (GcrImporter *self,GcrParser *parser);
Listen for parse events from the GcrParser, and queue parsed items for importing.
| 
 | The importer | 
| 
 | The parser to listen to | 
void gcr_importer_queue (GcrImporter *self,const gchar *label,GckAttributes *attrs);
Queue the importing of an item. Use gcr_importer_listen() to automatically
queue items parsed by a GcrParser.
| 
 | The importer | 
| 
 | Label of item to import | 
| 
 | Attributes of item to import | 
gboolean gcr_importer_import (GcrImporter *self,GCancellable *cancellable,GError **error);
Start an synchronous import operation of the items that have been queued.
| 
 | The importer | 
| 
 | An optional cancellation object | 
| 
 | A location to raise an error on failure | 
| Returns : | Whether the import was successful or not. | 
void gcr_importer_import_async (GcrImporter *self,GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Start an asynchronous import operation of the items that have been queued.
| 
 | The importer | 
| 
 | An optional cancellation object | 
| 
 | Call when the operation result is ready | 
| 
 | Data to pass to the callback | 
gboolean gcr_importer_import_finish (GcrImporter *self,GAsyncResult *result,GError **error);
Complete an asynchronous import operation.
| 
 | The importer | 
| 
 | The operation result | 
| 
 | A location to raise an error on failure. | 
| Returns : | Whether the operation was successful or not. | 
GckSlot *           gcr_importer_get_slot               (GcrImporter *self);
Get the PKCS#11 slot the items will be imported to, or after an import operation, which slot they have been imported to.
| 
 | The importer | 
| Returns : | The slot. | 
void gcr_importer_set_slot (GcrImporter *self,GckSlot *slot);
Set the PKCS#11 slot to import the items to.
| 
 | The importer | 
| 
 | The slot to import to | 
GcrImporterPromptBehavior gcr_importer_get_prompt_behavior
                                                        (GcrImporter *self);
Get the type of prompting configured for this importer.
| 
 | The importer | 
| Returns : | The prompting flags. | 
void gcr_importer_set_prompt_behavior (GcrImporter *self,GcrImporterPromptBehavior behavior);
Set the type of prompting desired during import.
| 
 | The importer | 
| 
 | The prompt behavior flag | 
GcrParser *         gcr_importer_get_parser             (GcrImporter *self);
gcr_importer_get_parser is deprecated and should not be used in newly-written code. Since 3.0.0
Has no effect. Use gcr_importer_listen() instead.
| 
 | An importer | 
| Returns : | NULLis always returned. | 
void gcr_importer_set_parser (GcrImporter *self,GcrParser *parser);
gcr_importer_set_parser is deprecated and should not be used in newly-written code. Since 3.0.0
Has no effect. Use gcr_importer_listen() instead.
| 
 | An importer | 
| 
 | A parser | 
"prompt-behavior" property"prompt-behavior" gint : Read / Write
Import Prompt Behavior.
Allowed values: >= 0
Default value: 0
"imported" signalvoid                user_function                      (GcrImporter *object,
                                                        GckObject   *arg1,
                                                        gpointer     user_data)      : Run First
This signal is emitted when an item has been imported.
| 
 | The object which was imported. | 
| 
 | user data set when the signal handler was connected. | 
"queued" signalvoid                user_function                      (GcrImporter *label,
                                                        gchar       *attrs,
                                                        gpointer     user_data)      : Run First
This signal is emitted when an item is queued for import.
| 
 | The label of the queued item. | 
| 
 | The attributes of the queued item. | 
| 
 | user data set when the signal handler was connected. |