<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GckObject: Gck Library Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="Gck Library Reference Manual">
<link rel="up" href="reference.html" title="PKCS#11 GObject Bindings">
<link rel="prev" href="GckSession.html" title="GckSession">
<link rel="next" href="gck-GckAttribute.html" title="GckAttribute">
<meta name="generator" content="GTK-Doc V1.27.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
<a href="#GckObject.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
<a href="#GckObject.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_derived_interfaces"> <span class="dim">|</span>
<a href="#GckObject.derived-interfaces" class="shortcut">Known Derived Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span>
<a href="#GckObject.properties" class="shortcut">Properties</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="reference.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GckSession.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="gck-GckAttribute.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GckObject"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GckObject.top_of_page"></a>GckObject</span></h2>
<p>GckObject — Represents a PKCS11 object such as a key or certificate.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GckObject.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GckObject.html" title="GckObject"><span class="returnvalue">GckObject</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-from-handle" title="gck_object_from_handle ()">gck_object_from_handle</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-objects-from-handle-array" title="gck_objects_from_handle_array ()">gck_objects_from_handle_array</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-equal" title="gck_object_equal ()">gck_object_equal</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guint</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-hash" title="gck_object_hash ()">gck_object_hash</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckModule.html" title="GckModule"><span class="returnvalue">GckModule</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-module" title="gck_object_get_module ()">gck_object_get_module</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gulong</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-handle" title="gck_object_get_handle ()">gck_object_get_handle</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckSession.html" title="GckSession"><span class="returnvalue">GckSession</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-session" title="gck_object_get_session ()">gck_object_get_session</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-destroy" title="gck_object_destroy ()">gck_object_destroy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-destroy-async" title="gck_object_destroy_async ()">gck_object_destroy_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-destroy-finish" title="gck_object_destroy_finish ()">gck_object_destroy_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-set" title="gck_object_set ()">gck_object_set</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-set-async" title="gck_object_set_async ()">gck_object_set_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-set-finish" title="gck_object_set_finish ()">gck_object_set_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get" title="gck_object_get ()">gck_object_get</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-async" title="gck_object_get_async ()">gck_object_get_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-finish" title="gck_object_get_finish ()">gck_object_get_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guchar</span> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-data" title="gck_object_get_data ()">gck_object_get_data</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guchar</span> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-data-full" title="gck_object_get_data_full ()">gck_object_get_data_full</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-data-async" title="gck_object_get_data_async ()">gck_object_get_data_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">guchar</span> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-data-finish" title="gck_object_get_data_finish ()">gck_object_get_data_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-full" title="gck_object_get_full ()">gck_object_get_full</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-template" title="gck_object_get_template ()">gck_object_get_template</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-template-async" title="gck_object_get_template_async ()">gck_object_get_template_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-get-template-finish" title="gck_object_get_template_finish ()">gck_object_get_template_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-set-template" title="gck_object_set_template ()">gck_object_set_template</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-set-template-async" title="gck_object_set_template_async ()">gck_object_set_template_async</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GckObject.html#gck-object-set-template-finish" title="gck_object_set_template_finish ()">gck_object_set_template_finish</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GckObject.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type"><span class="type">gulong</span></td>
<td class="property_name"><a class="link" href="GckObject.html#GckObject--handle" title="The “handle” property">handle</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GckModule.html" title="GckModule"><span class="type">GckModule</span></a> *</td>
<td class="property_name"><a class="link" href="GckObject.html#GckObject--module" title="The “module” property">module</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
<tr>
<td class="property_type">
<a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *</td>
<td class="property_name"><a class="link" href="GckObject.html#GckObject--session" title="The “session” property">session</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GckObject.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GckObject.html#GckObject-struct" title="struct GckObject">GckObject</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GckObject.html#GckObjectClass" title="struct GckObjectClass">GckObjectClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GckObject.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GckObject
</pre>
</div>
<div class="refsect1">
<a name="GckObject.derived-interfaces"></a><h2>Known Derived Interfaces</h2>
<p>
GckObject is required by
<a class="link" href="GckObjectCache.html" title="GckObjectCache">GckObjectCache</a>.</p>
</div>
<div class="refsect1">
<a name="GckObject.description"></a><h2>Description</h2>
<p>A GckObject holds a handle to a PKCS11 object such as a key or certificate. Token objects
are stored on the token persistently. Others are transient and are called session objects.</p>
</div>
<div class="refsect1">
<a name="GckObject.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gck-object-from-handle"></a><h3>gck_object_from_handle ()</h3>
<pre class="programlisting"><a class="link" href="GckObject.html" title="GckObject"><span class="returnvalue">GckObject</span></a> *
gck_object_from_handle (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *session</code></em>,
<em class="parameter"><code><span class="type">gulong</span> object_handle</code></em>);</pre>
<p>Initialize a GckObject from a raw PKCS#11 handle. Normally you would use
<a class="link" href="GckSession.html#gck-session-create-object" title="gck_session_create_object ()"><code class="function">gck_session_create_object()</code></a> or <a class="link" href="GckSession.html#gck-session-find-objects" title="gck_session_find_objects ()"><code class="function">gck_session_find_objects()</code></a> to access objects.</p>
<div class="refsect3">
<a name="gck-object-from-handle.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>session</p></td>
<td class="parameter_description"><p>The session through which this object is accessed or created.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_handle</p></td>
<td class="parameter_description"><p>The raw CK_OBJECT_HANDLE of the object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-from-handle.returns"></a><h4>Returns</h4>
<p>The new GckObject. You should use
<code class="function">g_object_unref()</code> when done with this object. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-objects-from-handle-array"></a><h3>gck_objects_from_handle_array ()</h3>
<pre class="programlisting"><span class="returnvalue">GList</span> *
gck_objects_from_handle_array (<em class="parameter"><code><a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *session</code></em>,
<em class="parameter"><code><span class="type">gulong</span> *object_handles</code></em>,
<em class="parameter"><code><span class="type">gulong</span> n_object_handles</code></em>);</pre>
<p>Initialize a list of GckObject from raw PKCS#11 handles. The handles argument must contain
contiguous CK_OBJECT_HANDLE handles in an array.</p>
<div class="refsect3">
<a name="gck-objects-from-handle-array.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>session</p></td>
<td class="parameter_description"><p>The session for these objects</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>object_handles</p></td>
<td class="parameter_description"><p>The raw object handles. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_object_handles]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>n_object_handles</p></td>
<td class="parameter_description"><p>The number of raw object handles.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-objects-from-handle-array.returns"></a><h4>Returns</h4>
<p>The list of <a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a>
objects. You should use <a class="link" href="gck-Miscellaneous-Functions.html#gck-list-unref-free" title="gck_list_unref_free ()"><code class="function">gck_list_unref_free()</code></a> when done with this
list. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> Gck.Object]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-equal"></a><h3>gck_object_equal ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_equal (<em class="parameter"><code><span class="type">gconstpointer</span> object1</code></em>,
<em class="parameter"><code><span class="type">gconstpointer</span> object2</code></em>);</pre>
<p>Checks equality of two objects. Two GckObject objects can point to the same
underlying PKCS#11 object.</p>
<div class="refsect3">
<a name="gck-object-equal.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>object1</p></td>
<td class="parameter_description"><p>a pointer to the first <a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gck.Object]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>object2</p></td>
<td class="parameter_description"><p>a pointer to the second <a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gck.Object]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-equal.returns"></a><h4>Returns</h4>
<p> TRUE if object1 and object2 are equal. FALSE if either is not a GckObject.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-hash"></a><h3>gck_object_hash ()</h3>
<pre class="programlisting"><span class="returnvalue">guint</span>
gck_object_hash (<em class="parameter"><code><span class="type">gconstpointer</span> object</code></em>);</pre>
<p>Create a hash value for the GckObject.</p>
<p>This function is intended for easily hashing a GckObject to add to
a GHashTable or similar data structure.</p>
<div class="refsect3">
<a name="gck-object-hash.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>a pointer to a <a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> Gck.Object]</span></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-hash.returns"></a><h4>Returns</h4>
<p> An integer that can be used as a hash value, or 0 if invalid.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-module"></a><h3>gck_object_get_module ()</h3>
<pre class="programlisting"><a class="link" href="GckModule.html" title="GckModule"><span class="returnvalue">GckModule</span></a> *
gck_object_get_module (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>);</pre>
<p>Get the PKCS#11 module to which this object belongs.</p>
<div class="refsect3">
<a name="gck-object-get-module.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-module.returns"></a><h4>Returns</h4>
<p>the module, which should be unreffed after use. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-handle"></a><h3>gck_object_get_handle ()</h3>
<pre class="programlisting"><span class="returnvalue">gulong</span>
gck_object_get_handle (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>);</pre>
<p>Get the raw PKCS#11 handle of a GckObject.</p>
<div class="refsect3">
<a name="gck-object-get-handle.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-handle.returns"></a><h4>Returns</h4>
<p> the raw CK_OBJECT_HANDLE object handle</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-session"></a><h3>gck_object_get_session ()</h3>
<pre class="programlisting"><a class="link" href="GckSession.html" title="GckSession"><span class="returnvalue">GckSession</span></a> *
gck_object_get_session (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>);</pre>
<p>Get the PKCS#11 session assigned to make calls on when operating
on this object.</p>
<p>This will only return a session if it was set explitly on this
object. By default an object will open and close sessions
appropriate for its calls.</p>
<div class="refsect3">
<a name="gck-object-get-session.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-session.returns"></a><h4>Returns</h4>
<p>the assigned session, which must be unreffed after use. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-destroy"></a><h3>gck_object_destroy ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_destroy (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Destroy a PKCS#11 object, deleting it from storage or the session.
This call may block for an indefinite period.</p>
<div class="refsect3">
<a name="gck-object-destroy.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to destroy.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellable object, or NULL to ignore.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to return an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-destroy.returns"></a><h4>Returns</h4>
<p> Whether the call was successful or not.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-destroy-async"></a><h3>gck_object_destroy_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gck_object_destroy_async (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Destroy a PKCS#11 object, deleting it from storage or the session.
This call will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="gck-object-destroy-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to destroy.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellable object, or NULL to ignore.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>Callback which is called when operation completes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>Data to pass to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-destroy-finish"></a><h3>gck_object_destroy_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_destroy_finish (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the status of the operation to destroy a PKCS#11 object, begun with
<a class="link" href="GckObject.html#gck-object-destroy-async" title="gck_object_destroy_async ()"><code class="function">gck_object_destroy_async()</code></a>.</p>
<div class="refsect3">
<a name="gck-object-destroy-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object being destroyed.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>The result of the destory operation passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-destroy-finish.returns"></a><h4>Returns</h4>
<p> Whether the object was destroyed successfully or not.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-set"></a><h3>gck_object_set ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_set (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Set PKCS#11 attributes on an object. This call may block for an indefinite period.</p>
<p>If the <em class="parameter"><code>attrs</code></em>
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> is floating, it is consumed.</p>
<div class="refsect3">
<a name="gck-object-set.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to set attributes on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attrs</p></td>
<td class="parameter_description"><p>The attributes to set on the object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellable object, or NULL to ignore.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to return an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-set.returns"></a><h4>Returns</h4>
<p> Whether the call was successful or not.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-set-async"></a><h3>gck_object_set_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gck_object_set_async (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Set PKCS#11 attributes on an object. This call will return
immediately and completes asynchronously.</p>
<p>If the <em class="parameter"><code>attrs</code></em>
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> is floating, it is consumed.</p>
<div class="refsect3">
<a name="gck-object-set-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to set attributes on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attrs</p></td>
<td class="parameter_description"><p>The attributes to set on the object.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellable object, or NULL to ignore.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>Callback which is called when operation completes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>Data to pass to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-set-finish"></a><h3>gck_object_set_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_set_finish (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the status of the operation to set attributes on a PKCS#11 object,
begun with <a class="link" href="GckObject.html#gck-object-set-async" title="gck_object_set_async ()"><code class="function">gck_object_set_async()</code></a>.</p>
<div class="refsect3">
<a name="gck-object-set-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to set attributes on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>The result of the destory operation passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-set-finish.returns"></a><h4>Returns</h4>
<p> Whether the attributes were successfully set on the object or not.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get"></a><h3>gck_object_get ()</h3>
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
gck_object_get (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Get the specified attributes from the object. This call may
block for an indefinite period.</p>
<div class="refsect3">
<a name="gck-object-get.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attributes from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>The attribute types to get.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get.returns"></a><h4>Returns</h4>
<p>the resulting PKCS#11 attributes, or <code class="literal">NULL</code> if an
error occurred; the result must be unreffed when you're finished
with it. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-async"></a><h3>gck_object_get_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gck_object_get_async (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">gulong</span> *attr_types</code></em>,
<em class="parameter"><code><span class="type">guint</span> n_attr_types</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Get the specified attributes from the object. The attributes will be cleared
of their current values, and new attributes will be stored. The attributes
should not be accessed in any way except for referencing and unreferencing
them until <a class="link" href="GckObject.html#gck-object-get-finish" title="gck_object_get_finish ()"><code class="function">gck_object_get_finish()</code></a> is called.</p>
<p>This call returns immediately and completes asynchronously.</p>
<div class="refsect3">
<a name="gck-object-get-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attributes from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_types</p></td>
<td class="parameter_description"><p>the types of the attributes to get. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_attr_types]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>n_attr_types</p></td>
<td class="parameter_description"><p>the number of attr_types</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object, or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>A callback which is called when the operation completes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>Data to be passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-finish"></a><h3>gck_object_get_finish ()</h3>
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
gck_object_get_finish (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the result of a get operation and return specified attributes from
the object.</p>
<p>No extra references are added to the returned attributes pointer.</p>
<div class="refsect3">
<a name="gck-object-get-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attributes from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>The result passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-finish.returns"></a><h4>Returns</h4>
<p> The filled in attributes structure if successful or
NULL if not successful.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-data"></a><h3>gck_object_get_data ()</h3>
<pre class="programlisting"><span class="returnvalue">guchar</span> *
gck_object_get_data (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">gsize</span> *n_data</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the data for the specified attribute from the object. For convenience
the returned data has a null terminator.</p>
<p>This call may block for an indefinite period.</p>
<div class="refsect3">
<a name="gck-object-get-data.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attribute data from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The attribute to get data for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>A <span class="type">GCancellable</span> or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_data</p></td>
<td class="parameter_description"><p>The length of the resulting data.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-data.returns"></a><h4>Returns</h4>
<p>the resulting PKCS#11
attribute data, or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_data]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-data-full"></a><h3>gck_object_get_data_full ()</h3>
<pre class="programlisting"><span class="returnvalue">guchar</span> *
gck_object_get_data_full (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><span class="type">GckAllocator</span> allocator</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">gsize</span> *n_data</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the data for the specified attribute from the object. For convenience
the returned data has an extra null terminator, not included in the returned length.</p>
<p>This call may block for an indefinite period.</p>
<p><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></p>
<div class="refsect3">
<a name="gck-object-get-data-full.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attribute data from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The attribute to get data for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>allocator</p></td>
<td class="parameter_description"><p>An allocator with which to allocate memory for the data, or NULL for default.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellation object, or NULL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_data</p></td>
<td class="parameter_description"><p>The length of the resulting data.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-data-full.returns"></a><h4>Returns</h4>
<p>The resulting PKCS#11
attribute data, or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_data]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-data-async"></a><h3>gck_object_get_data_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gck_object_get_data_async (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><span class="type">GckAllocator</span> allocator</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Get the data for the specified attribute from the object.</p>
<p>This call will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="gck-object-get-data-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attribute data from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The attribute to get data for.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>allocator</p></td>
<td class="parameter_description"><p>An allocator with which to allocate memory for the data, or NULL for default. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Exposed in C code, not necessarily available in other languages."><span class="acronym">skip</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellation object, or NULL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>Called when the operation completes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>Data to be passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-data-finish"></a><h3>gck_object_get_data_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">guchar</span> *
gck_object_get_data_finish (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
<em class="parameter"><code><span class="type">gsize</span> *n_data</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the result of an operation to get attribute data from
an object. For convenience the returned data has an extra null terminator,
not included in the returned length.</p>
<div class="refsect3">
<a name="gck-object-get-data-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get an attribute from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>The result passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>n_data</p></td>
<td class="parameter_description"><p>The length of the resulting data.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-data-finish.returns"></a><h4>Returns</h4>
<p>The PKCS#11 attribute data
or <code class="literal">NULL</code> if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_data]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-full"></a><h3>gck_object_get_full ()</h3>
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
gck_object_get_full (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code>const <span class="type">gulong</span> *attr_types</code></em>,
<em class="parameter"><code><span class="type">guint</span> n_attr_types</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the specified attributes from the object. This call may
block for an indefinite period.</p>
<p>No extra references are added to the returned attributes pointer.
During this call you may not access the attributes in any way.</p>
<div class="refsect3">
<a name="gck-object-get-full.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get attributes from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_types</p></td>
<td class="parameter_description"><p>the types of the attributes to get. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=n_attr_types]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>n_attr_types</p></td>
<td class="parameter_description"><p>the number of attr_types</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>optional cancellation object, or <code class="literal">NULL</code></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-full.returns"></a><h4>Returns</h4>
<p>a pointer to the filled in attributes if successful,
or <code class="literal">NULL</code> if not. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-template"></a><h3>gck_object_get_template ()</h3>
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
gck_object_get_template (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get an attribute template from the object. The attr_type must be for
an attribute which returns a template.</p>
<p>This call may block for an indefinite period.</p>
<div class="refsect3">
<a name="gck-object-get-template.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get an attribute template from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The template attribute type.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellation object, or NULL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-template.returns"></a><h4>Returns</h4>
<p>the resulting PKCS#11 attribute template, or <code class="literal">NULL</code>
if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-template-async"></a><h3>gck_object_get_template_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gck_object_get_template_async (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Get an attribute template from the object. The attr_type must be for
an attribute which returns a template.</p>
<p>This call will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="gck-object-get-template-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get an attribute template from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The template attribute type.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellation object, or NULL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>Called when the operation completes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>Data to be passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-get-template-finish"></a><h3>gck_object_get_template_finish ()</h3>
<pre class="programlisting"><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> *
gck_object_get_template_finish (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the result of an operation to get attribute template from
an object.</p>
<div class="refsect3">
<a name="gck-object-get-template-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to get an attribute from.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>The result passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-get-template-finish.returns"></a><h4>Returns</h4>
<p>the resulting PKCS#11 attribute template, or <code class="literal">NULL</code>
if an error occurred. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-set-template"></a><h3>gck_object_set_template ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_set_template (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Set an attribute template on the object. The attr_type must be for
an attribute which contains a template.</p>
<p>If the <em class="parameter"><code>attrs</code></em>
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> is floating, it is consumed.</p>
<p>This call may block for an indefinite period.</p>
<div class="refsect3">
<a name="gck-object-set-template.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to set an attribute template on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The attribute template type.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attrs</p></td>
<td class="parameter_description"><p>The attribute template.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellation object, or NULL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-set-template.returns"></a><h4>Returns</h4>
<p> TRUE if the operation succeeded.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-set-template-async"></a><h3>gck_object_set_template_async ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gck_object_set_template_async (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">gulong</span> attr_type</code></em>,
<em class="parameter"><code><a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
<em class="parameter"><code><span class="type">GCancellable</span> *cancellable</code></em>,
<em class="parameter"><code><span class="type">GAsyncReadyCallback</span> callback</code></em>,
<em class="parameter"><code><span class="type">gpointer</span> user_data</code></em>);</pre>
<p>Set an attribute template on the object. The attr_type must be for
an attribute which contains a template.</p>
<p>If the <em class="parameter"><code>attrs</code></em>
<a class="link" href="GckAttributes.html" title="GckAttributes"><span class="type">GckAttributes</span></a> is floating, it is consumed.</p>
<p>This call will return immediately and complete asynchronously.</p>
<div class="refsect3">
<a name="gck-object-set-template-async.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to set an attribute template on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attr_type</p></td>
<td class="parameter_description"><p>The attribute template type.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>attrs</p></td>
<td class="parameter_description"><p>The attribute template.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>cancellable</p></td>
<td class="parameter_description"><p>Optional cancellation object, or NULL.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>callback</p></td>
<td class="parameter_description"><p>Called when the operation completes.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>Data to be passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gck-object-set-template-finish"></a><h3>gck_object_set_template_finish ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gck_object_set_template_finish (<em class="parameter"><code><a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a> *self</code></em>,
<em class="parameter"><code><span class="type">GAsyncResult</span> *result</code></em>,
<em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
<p>Get the result of an operation to set attribute template on
an object.</p>
<div class="refsect3">
<a name="gck-object-set-template-finish.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>self</p></td>
<td class="parameter_description"><p>The object to set an attribute template on.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>result</p></td>
<td class="parameter_description"><p>The result passed to the callback.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>A location to store an error.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gck-object-set-template-finish.returns"></a><h4>Returns</h4>
<p> TRUE if the operation succeeded.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="GckObject.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GckObject-struct"></a><h3>struct GckObject</h3>
<pre class="programlisting">struct GckObject;</pre>
<p>Represents a PKCS11 object handle such as a key or certifiacte.</p>
</div>
<hr>
<div class="refsect2">
<a name="GckObjectClass"></a><h3>struct GckObjectClass</h3>
<pre class="programlisting">struct GckObjectClass {
GObjectClass parent;
};
</pre>
<p>The class for a <a class="link" href="GckObject.html" title="GckObject"><span class="type">GckObject</span></a>.</p>
<p>If the <em class="parameter"><code>attribute_types</code></em>
field is set by a derived class, then the a
<a class="link" href="GckEnumerator.html" title="GckEnumerator"><span class="type">GckEnumerator</span></a> which has been setup using <a class="link" href="GckEnumerator.html#gck-enumerator-set-object-type" title="gck_enumerator_set_object_type ()"><code class="function">gck_enumerator_set_object_type()</code></a>
with this derived type will retrieve these attributes when enumerating. In
this case the class must implement an 'attributes' property of boxed type
GCK_TYPE_ATTRIBUTES.</p>
<div class="refsect3">
<a name="GckObjectClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody><tr>
<td class="struct_member_name"><p><span class="type">GObjectClass</span> <em class="structfield"><code><a name="GckObjectClass.parent"></a>parent</code></em>;</p></td>
<td class="struct_member_description"><p>derived from this</p></td>
<td class="struct_member_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GckObject.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GckObject--handle"></a><h3>The <code class="literal">“handle”</code> property</h3>
<pre class="programlisting"> “handle” <span class="type">gulong</span></pre>
<p>The raw PKCS11 handle for this object.</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
<hr>
<div class="refsect2">
<a name="GckObject--module"></a><h3>The <code class="literal">“module”</code> property</h3>
<pre class="programlisting"> “module” <a class="link" href="GckModule.html" title="GckModule"><span class="type">GckModule</span></a> *</pre>
<p>The GckModule that this object belongs to.</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
<hr>
<div class="refsect2">
<a name="GckObject--session"></a><h3>The <code class="literal">“session”</code> property</h3>
<pre class="programlisting"> “session” <a class="link" href="GckSession.html" title="GckSession"><span class="type">GckSession</span></a> *</pre>
<p>The PKCS11 session to make calls on when this object needs to
perform operations on itself.</p>
<p>If this is NULL then a new session is opened for each operation,
such as <a class="link" href="GckObject.html#gck-object-get" title="gck_object_get ()"><code class="function">gck_object_get()</code></a>, <a class="link" href="GckObject.html#gck-object-set" title="gck_object_set ()"><code class="function">gck_object_set()</code></a> or <a class="link" href="GckObject.html#gck-object-destroy" title="gck_object_destroy ()"><code class="function">gck_object_destroy()</code></a>.</p>
<p>Flags: Read / Write / Construct Only</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.27.1</div>
</body>
</html>