1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>GckAttributes</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
7
<link rel="home" href="index.html" title="GCK Reference Manual">
8
<link rel="up" href="ch01.html" title="PKCS#11 GObject Bindings">
9
<link rel="prev" href="gck-GckAttribute.html" title="GckAttribute">
10
<link rel="next" href="gck-Errors.html" title="Errors">
11
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
17
<td><a accesskey="p" href="gck-GckAttribute.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
<th width="100%" align="center">GCK Reference Manual</th>
21
<td><a accesskey="n" href="gck-Errors.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
23
<tr><td colspan="5" class="shortcuts">
24
<a href="#gck-GckAttributes.synopsis" class="shortcut">Top</a>
26
<a href="#gck-GckAttributes.description" class="shortcut">Description</a>
29
<div class="refentry">
30
<a name="gck-GckAttributes"></a><div class="titlepage"></div>
31
<div class="refnamediv"><table width="100%"><tr>
33
<h2><span class="refentrytitle"><a name="gck-GckAttributes.top_of_page"></a>GckAttributes</span></h2>
34
<p>GckAttributes — A set of PKCS11 attributes.</p>
36
<td valign="top" align="right"></td>
38
<div class="refsynopsisdiv">
39
<a name="gck-GckAttributes.synopsis"></a><h2>Synopsis</h2>
40
<pre class="synopsis"> <a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes">GckAttributes</a>;
41
#define <a class="link" href="gck-GckAttributes.html#GCK-TYPE-ATTRIBUTES:CAPS" title="GCK_TYPE_ATTRIBUTES">GCK_TYPE_ATTRIBUTES</a>
42
<a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-new" title="gck_attributes_new ()">gck_attributes_new</a> (<em class="parameter"><code><span class="type">void</span></code></em>);
43
<a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-new-empty" title="gck_attributes_new_empty ()">gck_attributes_new_empty</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
44
<em class="parameter"><code>...</code></em>);
45
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-at" title="gck_attributes_at ()">gck_attributes_at</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
46
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);
47
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add" title="gck_attributes_add ()">gck_attributes_add</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
48
<em class="parameter"><code><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);
49
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-data" title="gck_attributes_add_data ()">gck_attributes_add_data</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
50
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
51
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> value</code></em>,
52
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);
53
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-invalid" title="gck_attributes_add_invalid ()">gck_attributes_add_invalid</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
54
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
55
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-empty" title="gck_attributes_add_empty ()">gck_attributes_add_empty</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
56
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
57
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-boolean" title="gck_attributes_add_boolean ()">gck_attributes_add_boolean</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
58
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
59
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);
60
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-string" title="gck_attributes_add_string ()">gck_attributes_add_string</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
61
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
62
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);
63
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-date" title="gck_attributes_add_date ()">gck_attributes_add_date</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
64
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
65
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
66
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-add-ulong" title="gck_attributes_add_ulong ()">gck_attributes_add_ulong</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
67
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
68
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);
69
<a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-find" title="gck_attributes_find ()">gck_attributes_find</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
70
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);
71
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gck-GckAttributes.html#gck-attributes-find-boolean" title="gck_attributes_find_boolean ()">gck_attributes_find_boolean</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
72
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
73
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);
74
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gck-GckAttributes.html#gck-attributes-find-ulong" title="gck_attributes_find_ulong ()">gck_attributes_find_ulong</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
75
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
76
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *value</code></em>);
77
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gck-GckAttributes.html#gck-attributes-find-string" title="gck_attributes_find_string ()">gck_attributes_find_string</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
78
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
79
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);
80
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="gck-GckAttributes.html#gck-attributes-find-date" title="gck_attributes_find_date ()">gck_attributes_find_date</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
81
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
82
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);
83
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> <a class="link" href="gck-GckAttributes.html#gck-attributes-count" title="gck_attributes_count ()">gck_attributes_count</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
84
<a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * <a class="link" href="gck-GckAttributes.html#gck-attributes-ref" title="gck_attributes_ref ()">gck_attributes_ref</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
85
<span class="returnvalue">void</span> <a class="link" href="gck-GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()">gck_attributes_unref</a> (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);
86
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (<a class="link" href="gck-GckAttributes.html#GckAllocator" title="GckAllocator ()">*GckAllocator</a>) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
87
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);
88
#define <a class="link" href="gck-GckAttributes.html#GCK-INVALID:CAPS" title="GCK_INVALID">GCK_INVALID</a>
91
<div class="refsect1">
92
<a name="gck-GckAttributes.description"></a><h2>Description</h2>
94
A set of GckAttribute structures. These attributes contain information
95
about a PKCS11 object. Use <a class="link" href="GckObject.html#gck-object-get" title="gck_object_get ()"><code class="function">gck_object_get()</code></a> or <a class="link" href="GckObject.html#gck-object-set" title="gck_object_set ()"><code class="function">gck_object_set()</code></a> to set and retrieve
96
attributes on an object.
99
<div class="refsect1">
100
<a name="gck-GckAttributes.details"></a><h2>Details</h2>
101
<div class="refsect2">
102
<a name="GckAttributes"></a><h3>GckAttributes</h3>
103
<pre class="programlisting">typedef struct _GckAttributes GckAttributes;</pre>
105
A set of GckAttribute structures.
109
<div class="refsect2">
110
<a name="GCK-TYPE-ATTRIBUTES:CAPS"></a><h3>GCK_TYPE_ATTRIBUTES</h3>
111
<pre class="programlisting">#define GCK_TYPE_ATTRIBUTES (gck_attributes_get_boxed_type ())
117
<div class="refsect2">
118
<a name="gck-attributes-new"></a><h3>gck_attributes_new ()</h3>
119
<pre class="programlisting"><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
121
Create a new GckAttributes array.
123
<div class="variablelist"><table border="0">
124
<col align="left" valign="top">
126
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
127
<td>The new attributes array. When done with the array
128
release it with <a class="link" href="gck-GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>.</td>
133
<div class="refsect2">
134
<a name="gck-attributes-new-empty"></a><h3>gck_attributes_new_empty ()</h3>
135
<pre class="programlisting"><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_new_empty (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
136
<em class="parameter"><code>...</code></em>);</pre>
138
Creates an GckAttributes array with empty attributes. The arguments
139
should be values of attribute types, terminated with gck_INVALID.
141
<div class="variablelist"><table border="0">
142
<col align="left" valign="top">
145
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
146
<td>The first attribute type to add as empty.</td>
149
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
150
<td>The arguments should be values of attribute types, terminated with gck_INVALID.</td>
153
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
154
<td>The new attributes array. When done with the array
155
release it with <a class="link" href="gck-GckAttributes.html#gck-attributes-unref" title="gck_attributes_unref ()"><code class="function">gck_attributes_unref()</code></a>.</td>
161
<div class="refsect2">
162
<a name="gck-attributes-at"></a><h3>gck_attributes_at ()</h3>
163
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_at (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
164
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
166
Get attribute at the specified index in the attribute array.
169
Use <a class="link" href="gck-GckAttributes.html#gck-attributes-count" title="gck_attributes_count ()"><code class="function">gck_attributes_count()</code></a> to determine how many attributes are
172
<div class="variablelist"><table border="0">
173
<col align="left" valign="top">
176
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
177
<td>The attributes array.</td>
180
<td><p><span class="term"><em class="parameter"><code>index</code></em> :</span></p></td>
181
<td>The attribute index to retrieve.</td>
184
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
185
<td>The specified attribute.</td>
191
<div class="refsect2">
192
<a name="gck-attributes-add"></a><h3>gck_attributes_add ()</h3>
193
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
194
<em class="parameter"><code><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="type">GckAttribute</span></a> *attr</code></em>);</pre>
196
Add the specified attribute to the array.
199
The value stored in the attribute will be copied.
201
<div class="variablelist"><table border="0">
202
<col align="left" valign="top">
205
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
206
<td>The attributes array to add to</td>
209
<td><p><span class="term"><em class="parameter"><code>attr</code></em> :</span></p></td>
210
<td>The attribute to add.</td>
213
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
214
<td>The attribute that was added.</td>
220
<div class="refsect2">
221
<a name="gck-attributes-add-data"></a><h3>gck_attributes_add_data ()</h3>
222
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_data (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
223
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
224
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> value</code></em>,
225
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
227
Add an attribute with the specified type and value to the array.
230
The value stored in the attribute will be copied.
232
<div class="variablelist"><table border="0">
233
<col align="left" valign="top">
236
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
237
<td>The attributes array to add to.</td>
240
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
241
<td>The type of attribute to add.</td>
244
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
245
<td>The raw memory of the attribute value.</td>
248
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
249
<td>The length of the attribute value.</td>
252
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
253
<td>The attribute that was added.</td>
259
<div class="refsect2">
260
<a name="gck-attributes-add-invalid"></a><h3>gck_attributes_add_invalid ()</h3>
261
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_invalid (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
262
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
264
Add an attribute with the specified type and an 'invalid' value to the array.
266
<div class="variablelist"><table border="0">
267
<col align="left" valign="top">
270
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
271
<td>The attributes array to add to.</td>
274
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
275
<td>The type of attribute to add.</td>
278
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
279
<td>The attribute that was added.</td>
285
<div class="refsect2">
286
<a name="gck-attributes-add-empty"></a><h3>gck_attributes_add_empty ()</h3>
287
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_empty (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
288
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
290
Add an attribute with the specified type, with empty data.
292
<div class="variablelist"><table border="0">
293
<col align="left" valign="top">
296
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
297
<td>The attributes array to add.</td>
300
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
301
<td>The type of attribute to add.</td>
304
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
305
<td>The attribute that was added.</td>
311
<div class="refsect2">
312
<a name="gck-attributes-add-boolean"></a><h3>gck_attributes_add_boolean ()</h3>
313
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_boolean (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
314
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
315
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> value</code></em>);</pre>
317
Add an attribute with the specified type and value to the array.
320
The value will be stored as a CK_BBOOL PKCS<span class="type">11</span> style attribute.
322
<div class="variablelist"><table border="0">
323
<col align="left" valign="top">
326
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
327
<td>The attributes array to add to.</td>
330
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
331
<td>The type of attribute to add.</td>
334
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
335
<td>The boolean value to add.</td>
338
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
339
<td>The attribute that was added.</td>
345
<div class="refsect2">
346
<a name="gck-attributes-add-string"></a><h3>gck_attributes_add_string ()</h3>
347
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_string (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
348
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
349
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *value</code></em>);</pre>
351
Add an attribute with the specified type and value to the array.
354
The value will be copied into the attribute.
356
<div class="variablelist"><table border="0">
357
<col align="left" valign="top">
360
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
361
<td>The attributes array to add to.</td>
364
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
365
<td>The type of attribute to add.</td>
368
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
369
<td>The null terminated string value to add.</td>
372
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
373
<td>The attribute that was added.</td>
379
<div class="refsect2">
380
<a name="gck-attributes-add-date"></a><h3>gck_attributes_add_date ()</h3>
381
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_date (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
382
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
383
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
385
Add an attribute with the specified type and value to the array.
388
The value will be stored as a CK_DATE PKCS<span class="type">11</span> style attribute.
390
<div class="variablelist"><table border="0">
391
<col align="left" valign="top">
394
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
395
<td>The attributes array to add to.</td>
398
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
399
<td>The type of attribute to add.</td>
402
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
403
<td>The GDate value to add.</td>
406
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
407
<td>The attribute that was added.</td>
413
<div class="refsect2">
414
<a name="gck-attributes-add-ulong"></a><h3>gck_attributes_add_ulong ()</h3>
415
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_add_ulong (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
416
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
417
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> value</code></em>);</pre>
419
Add an attribute with the specified type and value to the array.
422
The value will be stored as a CK_ULONG PKCS<span class="type">11</span> style attribute.
424
<div class="variablelist"><table border="0">
425
<col align="left" valign="top">
428
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
429
<td>The attributes array to add to.</td>
432
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
433
<td>The type of attribute to add.</td>
436
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
437
<td>The gulong value to add.</td>
440
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
441
<td>The attribute that was added.</td>
447
<div class="refsect2">
448
<a name="gck-attributes-find"></a><h3>gck_attributes_find ()</h3>
449
<pre class="programlisting"><a class="link" href="gck-GckAttribute.html#GckAttribute" title="GckAttribute"><span class="returnvalue">GckAttribute</span></a> * gck_attributes_find (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
450
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>);</pre>
452
Find an attribute with the specified type in the array.
454
<div class="variablelist"><table border="0">
455
<col align="left" valign="top">
458
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
459
<td>The attributes array to search.</td>
462
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
463
<td>The type of attribute to find.</td>
466
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
467
<td>The first attribute found with the specified type, or NULL.</td>
473
<div class="refsect2">
474
<a name="gck-attributes-find-boolean"></a><h3>gck_attributes_find_boolean ()</h3>
475
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_boolean (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
476
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
477
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
479
Find an attribute with the specified type in the array.
482
The attribute (if found) must be of the right size to store
483
a boolean value (ie: CK_BBOOL). If the attribute is marked invalid
484
then it will be treated as not found.
486
<div class="variablelist"><table border="0">
487
<col align="left" valign="top">
490
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
491
<td>The attributes array to search.</td>
494
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
495
<td>The type of attribute to find.</td>
498
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
499
<td>The resulting gboolean value.</td>
502
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
503
<td>Whether a value was found or not.</td>
509
<div class="refsect2">
510
<a name="gck-attributes-find-ulong"></a><h3>gck_attributes_find_ulong ()</h3>
511
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_ulong (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
512
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
513
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> *value</code></em>);</pre>
515
Find an attribute with the specified type in the array.
518
The attribute (if found) must be of the right size to store
519
a unsigned long value (ie: CK_ULONG). If the attribute is marked invalid
520
then it will be treated as not found.
522
<div class="variablelist"><table border="0">
523
<col align="left" valign="top">
526
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
527
<td>The attributes array to search.</td>
530
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
531
<td>The type of attribute to find.</td>
534
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
535
<td>The resulting gulong value.</td>
538
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
539
<td>Whether a value was found or not.</td>
545
<div class="refsect2">
546
<a name="gck-attributes-find-string"></a><h3>gck_attributes_find_string ()</h3>
547
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_string (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
548
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
549
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);</pre>
551
Find an attribute with the specified type in the array.
554
If the attribute is marked invalid then it will be treated as not found.
555
The resulting string will be null-terminated, and must be freed by the caller
556
using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
558
<div class="variablelist"><table border="0">
559
<col align="left" valign="top">
562
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
563
<td>The attributes array to search.</td>
566
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
567
<td>The type of attribute to find.</td>
570
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
571
<td>The resulting string value.</td>
574
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
575
<td>Whether a value was found or not.</td>
581
<div class="refsect2">
582
<a name="gck-attributes-find-date"></a><h3>gck_attributes_find_date ()</h3>
583
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> gck_attributes_find_date (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>,
584
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="type">gulong</span></a> attr_type</code></em>,
585
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> *value</code></em>);</pre>
587
Find an attribute with the specified type in the array.
590
The attribute (if found) must be of the right size to store
591
a date value (ie: CK_DATE). If the attribute is marked invalid
592
then it will be treated as not found.
594
<div class="variablelist"><table border="0">
595
<col align="left" valign="top">
598
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
599
<td>The attributes array to search.</td>
602
<td><p><span class="term"><em class="parameter"><code>attr_type</code></em> :</span></p></td>
603
<td>The type of attribute to find.</td>
606
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
607
<td>The resulting GDate value.</td>
610
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
611
<td>Whether a value was found or not.</td>
617
<div class="refsect2">
618
<a name="gck-attributes-count"></a><h3>gck_attributes_count ()</h3>
619
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"><span class="returnvalue">gulong</span></a> gck_attributes_count (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
621
Get the number of attributes in this attribute array.
623
<div class="variablelist"><table border="0">
624
<col align="left" valign="top">
627
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
628
<td>The attributes array to count.</td>
631
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
632
<td>The number of contained attributes.</td>
638
<div class="refsect2">
639
<a name="gck-attributes-ref"></a><h3>gck_attributes_ref ()</h3>
640
<pre class="programlisting"><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="returnvalue">GckAttributes</span></a> * gck_attributes_ref (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
642
Reference this attributes array.
644
<div class="variablelist"><table border="0">
645
<col align="left" valign="top">
648
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
649
<td>An attribute array</td>
652
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
653
<td>The attributes.</td>
659
<div class="refsect2">
660
<a name="gck-attributes-unref"></a><h3>gck_attributes_unref ()</h3>
661
<pre class="programlisting"><span class="returnvalue">void</span> gck_attributes_unref (<em class="parameter"><code><a class="link" href="gck-GckAttributes.html#GckAttributes" title="GckAttributes"><span class="type">GckAttributes</span></a> *attrs</code></em>);</pre>
663
Unreference this attribute array.
666
When all outstanding references are NULL, the array will be freed.
668
<div class="variablelist"><table border="0">
669
<col align="left" valign="top">
671
<td><p><span class="term"><em class="parameter"><code>attrs</code></em> :</span></p></td>
672
<td>An attribute array</td>
677
<div class="refsect2">
678
<a name="GckAllocator"></a><h3>GckAllocator ()</h3>
679
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> (*GckAllocator) (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
680
<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"><span class="type">gsize</span></a> length</code></em>);</pre>
682
An allocator used to allocate data for the attributes in this GckAttributes set.
685
This is a function that acts like g_realloc. Specifically it frees when length is
686
set to zero, it allocates when data is set to NULL, and it reallocates when both
689
<div class="variablelist"><table border="0">
690
<col align="left" valign="top">
693
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
694
<td>Memory to allocate or deallocate.</td>
697
<td><p><span class="term"><em class="parameter"><code>length</code></em> :</span></p></td>
698
<td>New length of memory.</td>
701
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
702
<td>The allocated memory, or NULL when freeing.</td>
708
<div class="refsect2">
709
<a name="GCK-INVALID:CAPS"></a><h3>GCK_INVALID</h3>
710
<pre class="programlisting">#define GCK_INVALID G_MAXULONG
719
Generated by GTK-Doc V1.16</div>
b'\\ No newline at end of file'