|  |  |  | Gck Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
GList * gck_modules_initialize_registered (GCancellable *cancellable,GError **error); void gck_modules_initialize_registered_async (GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data); GList * gck_modules_initialize_registered_finish (GAsyncResult *result,GError **error); GckEnumerator * gck_modules_enumerate_objects (GList *modules,GckAttributes *attrs,GckSessionOptions session_options); GckEnumerator * gck_modules_enumerate_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error); GList * gck_modules_get_slots (GList *modules,gboolean token_present); GckObject * gck_modules_object_for_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error); GList * gck_modules_objects_for_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error); GckSlot * gck_modules_token_for_uri (GList *modules,const gchar *uri,GError **error); GList * gck_modules_tokens_for_uri (GList *modules,const gchar *uri,GError **error);
These functions are useful for dealing with lists of modules, and performing operations on all of them.
GList * gck_modules_initialize_registered (GCancellable *cancellable,GError **error);
Load and initialize all the registered modules.
| 
 | optional cancellation object. [allow-none] | 
| 
 | location to place an error on failure. [allow-none] | 
| Returns : | A newly allocated list
of GckModule objects, which should be released with gck_list_unref_free(). [transfer full][element-type Gck.Module] | 
void gck_modules_initialize_registered_async (GCancellable *cancellable,GAsyncReadyCallback callback,gpointer user_data);
Load and initialize all the registered modules asynchronously.
| 
 | optional cancellation object | 
| 
 | a callback which will be called when the operation completes | 
| 
 | data to pass to the callback | 
GList * gck_modules_initialize_registered_finish (GAsyncResult *result,GError **error);
Finishes the asynchronous operation to initialize the registered PKCS#11 modules.
| 
 | the asynchronous result | 
| 
 | location to place an error on failure | 
| Returns : | a list of newly initialized GckModule objects. [transfer full][element-type Gck.Module] | 
GckEnumerator * gck_modules_enumerate_objects (GList *modules,GckAttributes *attrs,GckSessionOptions session_options);
Setup an enumerator for listing matching objects on the modules.
This call will not block but will return an enumerator immediately.
If the attrs GckAttributes is floating, it is consumed.
| 
 | The modules. [element-type Gck.Module] | 
| 
 | attributes that the objects must have, or empty for all objects | 
| 
 | Options from GckSessionOptions | 
| Returns : | A new enumerator, which should be released
with g_object_unref(). [transfer full] | 
GckEnumerator * gck_modules_enumerate_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error);
Enumerate objects that match a URI.
This call will not block. Use the GckEnumerator functions in order to get at the actual objects that match.
| 
 | The modules. [element-type Gck.Module] | 
| 
 | The URI that the enumerator will match | 
| 
 | Options from GckSessionOptions | 
| 
 | A location to raise an error on failure. | 
| Returns : | A new GckEnumerator, or NULLif an error occurs. [transfer full] | 
GList * gck_modules_get_slots (GList *modules,gboolean token_present);
Get a list of slots for across all of the modules.
| 
 | The modules. [element-type Gck.Module] | 
| 
 | Whether to only list slots with token present | 
| Returns : | A list of GckSlot
objects, which should be freed with gck_list_unref_free(). [transfer full][element-type Gck.Slot] | 
GckObject * gck_modules_object_for_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error);
Find an object that matches a URI.
This call can block. Use gck_modules_enumerate_uri() for a non-blocking
version.
| 
 | The modules. [element-type Gck.Module] | 
| 
 | The URI the objects must match | 
| 
 | Options from GckSessionOptions | 
| 
 | A location to raise an error on failure. | 
| Returns : | A new GckObject which should be released with g_object_unref(), orNULLif no matching object was found. [transfer full][allow-none] | 
GList * gck_modules_objects_for_uri (GList *modules,const gchar *uri,GckSessionOptions session_options,GError **error);
Find objects that match a URI.
This call can block. Use gck_modules_enumerate_uri() for a non-blocking
version.
| 
 | The modules. [element-type Gck.Module] | 
| 
 | The URI the objects must match | 
| 
 | Options from GckSessionOptions | 
| 
 | A location to raise an error on failure. | 
| Returns : | A list of GckObject which
should be released with gck_list_unref_free(), orNULLif no matching object
was found. [transfer full][element-type Gck.Object] | 
GckSlot * gck_modules_token_for_uri (GList *modules,const gchar *uri,GError **error);
Lookup a token that matches the URI.
GList * gck_modules_tokens_for_uri (GList *modules,const gchar *uri,GError **error);
Lookup a token that matches the URI.
| 
 | The modules. [element-type Gck.Module] | 
| 
 | The URI that the token must match | 
| 
 | A location to raise an error on failure | 
| Returns : | A list of newly allocated
GckSlot objects. Use gck_list_unref_free()to release the list once you're
done with it. [transfer full][element-type Gck.Slot] |