![]() |
![]() |
![]() |
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 NULL if 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() , or NULL if 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() , or NULL if 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]
|