~ubuntu-branches/ubuntu/natty/gnome-keyring/natty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/gp11/html/gp11-gp11-object.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-10 21:37:48 UTC
  • mfrom: (1.1.59 upstream)
  • Revision ID: james.westby@ubuntu.com-20100310213748-imimrnfxu32ih4t3
Tags: 2.29.92-0ubuntu1
* New upstream version:
  - Fix various problems with not storing secret value properly.
  - Return no results when a search includes a bad collection identifier.
  - Don't raise error if ssh client disconnects early.
  - Allow running in a test environment.
  - Fix error when setting default keyring to NULL.
  - Autostart gnome-keyring-daemon in LXDE as well.
  - Rework the startup again, to use a singleton crontrolled via dbus, to help
    when no process was started by pam.
  - Display password and confirm prompts when creating keyring.
  - Allow specifying CKA_ID when creating collection.
  - Give translatable label to created login keyring.
  - When no default keyring set, use login keyring.
  - Fix problem initializing socket path in rpc module.
  - Fix endless loop in reading data.
  - Potential fix or sporadic crash.
  - Solaris build fixes.
  - Updated translations.
* debian/patches/05_git_no_read_looping.patch:
  - the change is in the new version

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
<link rel="up" href="ch01.html" title="PKCS#11 GObject Bindings">
9
9
<link rel="prev" href="gp11-gp11-session.html" title="GP11Session">
10
10
<link rel="next" href="gp11-gp11-attribute.html" title="GP11Attribute">
11
 
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="PKCS#11 GObject Bindings">
14
14
</head>
23
23
</tr>
24
24
<tr><td colspan="5" class="shortcuts">
25
25
<a href="#gp11-gp11-object.synopsis" class="shortcut">Top</a>
26
 
                 | 
27
 
                <a href="#gp11-gp11-object.description" class="shortcut">Description</a>
28
 
                 | 
29
 
                <a href="#gp11-gp11-object.object-hierarchy" class="shortcut">Object Hierarchy</a>
30
 
                 | 
31
 
                <a href="#gp11-gp11-object.properties" class="shortcut">Properties</a>
 
26
                   | 
 
27
                  <a href="#gp11-gp11-object.description" class="shortcut">Description</a>
 
28
                   | 
 
29
                  <a href="#gp11-gp11-object.object-hierarchy" class="shortcut">Object Hierarchy</a>
 
30
                   | 
 
31
                  <a href="#gp11-gp11-object.properties" class="shortcut">Properties</a>
32
32
</td></tr>
33
33
</table>
34
34
<div class="refentry" title="GP11Object">
42
42
</tr></table></div>
43
43
<div class="refsynopsisdiv" title="Synopsis">
44
44
<a name="gp11-gp11-object.synopsis"></a><h2>Synopsis</h2>
45
 
<a name="GP11Object"></a><pre class="synopsis">
46
 
                    <a class="link" href="gp11-gp11-object.html#GP11Object-struct" title="GP11Object">GP11Object</a>;
47
 
<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a>*         <a class="link" href="gp11-gp11-object.html#gp11-object-from-handle" title="gp11_object_from_handle ()">gp11_object_from_handle</a>             (<a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a> *slot,
48
 
                                                         CK_OBJECT_HANDLE handle);
49
 
<a
50
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
51
 
>GList</a>*              <a class="link" href="gp11-gp11-object.html#gp11-objects-from-handle-array" title="gp11_objects_from_handle_array ()">gp11_objects_from_handle_array</a>      (<a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a> *slot,
52
 
                                                         CK_OBJECT_HANDLE_PTR handles,
53
 
                                                         CK_ULONG n_handles);
54
 
<a
55
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
56
 
>gboolean</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-equal" title="gp11_object_equal ()">gp11_object_equal</a>                   (<a
57
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"
58
 
>gconstpointer</a> object1,
59
 
                                                         <a
60
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"
61
 
>gconstpointer</a> object2);
62
 
<a
63
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
64
 
>guint</a>               <a class="link" href="gp11-gp11-object.html#gp11-object-hash" title="gp11_object_hash ()">gp11_object_hash</a>                    (<a
65
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"
66
 
>gconstpointer</a> object);
67
 
<a class="link" href="gp11-gp11-module.html#GP11Module">GP11Module</a>*         <a class="link" href="gp11-gp11-object.html#gp11-object-get-module" title="gp11_object_get_module ()">gp11_object_get_module</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);
68
 
<a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a>*           <a class="link" href="gp11-gp11-object.html#gp11-object-get-slot" title="gp11_object_get_slot ()">gp11_object_get_slot</a>                (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);
69
 
CK_OBJECT_HANDLE    <a class="link" href="gp11-gp11-object.html#gp11-object-get-handle" title="gp11_object_get_handle ()">gp11_object_get_handle</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);
70
 
<a class="link" href="gp11-gp11-session.html#GP11Session">GP11Session</a>*        <a class="link" href="gp11-gp11-object.html#gp11-object-get-session" title="gp11_object_get_session ()">gp11_object_get_session</a>             (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);
71
 
void                <a class="link" href="gp11-gp11-object.html#gp11-object-set-session" title="gp11_object_set_session ()">gp11_object_set_session</a>             (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
72
 
                                                         <a class="link" href="gp11-gp11-session.html#GP11Session">GP11Session</a> *session);
73
 
<a
74
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
75
 
>gboolean</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-destroy" title="gp11_object_destroy ()">gp11_object_destroy</a>                 (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
76
 
                                                         <a
77
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
78
 
>GError</a> **err);
79
 
<a
80
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
81
 
>gboolean</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-destroy-full" title="gp11_object_destroy_full ()">gp11_object_destroy_full</a>            (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
82
 
                                                         <a
83
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
84
 
>GCancellable</a> *cancellable,
85
 
                                                         <a
86
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
87
 
>GError</a> **err);
88
 
void                <a class="link" href="gp11-gp11-object.html#gp11-object-destroy-async" title="gp11_object_destroy_async ()">gp11_object_destroy_async</a>           (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
89
 
                                                         <a
90
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
91
 
>GCancellable</a> *cancellable,
92
 
                                                         <a
93
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
94
 
>GAsyncReadyCallback</a> callback,
95
 
                                                         <a
96
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
97
 
>gpointer</a> user_data);
98
 
<a
99
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
100
 
>gboolean</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-destroy-finish" title="gp11_object_destroy_finish ()">gp11_object_destroy_finish</a>          (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
101
 
                                                         <a
102
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
103
 
>GAsyncResult</a> *result,
104
 
                                                         <a
105
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
106
 
>GError</a> **err);
107
 
<a
108
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
109
 
>gboolean</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-set" title="gp11_object_set ()">gp11_object_set</a>                     (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
110
 
                                                         <a
111
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
112
 
>GError</a> **err,
113
 
                                                         ...);
114
 
void                <a class="link" href="gp11-gp11-object.html#gp11-object-set-async" title="gp11_object_set_async ()">gp11_object_set_async</a>               (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
115
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a> *attrs,
116
 
                                                         <a
117
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
118
 
>GCancellable</a> *cancellable,
119
 
                                                         <a
120
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
121
 
>GAsyncReadyCallback</a> callback,
122
 
                                                         <a
123
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
124
 
>gpointer</a> user_data);
125
 
<a
126
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
127
 
>gboolean</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-set-finish" title="gp11_object_set_finish ()">gp11_object_set_finish</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
128
 
                                                         <a
129
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
130
 
>GAsyncResult</a> *result,
131
 
                                                         <a
132
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
133
 
>GError</a> **err);
134
 
<a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a>*     <a class="link" href="gp11-gp11-object.html#gp11-object-get" title="gp11_object_get ()">gp11_object_get</a>                     (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
135
 
                                                         <a
136
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
137
 
>GError</a> **err,
138
 
                                                         ...);
139
 
void                <a class="link" href="gp11-gp11-object.html#gp11-object-get-async" title="gp11_object_get_async ()">gp11_object_get_async</a>               (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
140
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a> *attrs,
141
 
                                                         <a
142
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
143
 
>GCancellable</a> *cancellable,
144
 
                                                         <a
145
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
146
 
>GAsyncReadyCallback</a> callback,
147
 
                                                         <a
148
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
149
 
>gpointer</a> user_data);
150
 
<a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a>*     <a class="link" href="gp11-gp11-object.html#gp11-object-get-finish" title="gp11_object_get_finish ()">gp11_object_get_finish</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
151
 
                                                         <a
152
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
153
 
>GAsyncResult</a> *result,
154
 
                                                         <a
155
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
156
 
>GError</a> **err);
157
 
<a
158
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
159
 
>gpointer</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-get-data" title="gp11_object_get_data ()">gp11_object_get_data</a>                (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
160
 
                                                         <a
161
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
162
 
>gulong</a> attr_type,
163
 
                                                         <a
164
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
165
 
>gsize</a> *n_data,
166
 
                                                         <a
167
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
168
 
>GError</a> **err);
169
 
<a
170
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
171
 
>gpointer</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-get-data-full" title="gp11_object_get_data_full ()">gp11_object_get_data_full</a>           (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
172
 
                                                         <a
173
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
174
 
>gulong</a> attr_type,
175
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()">GP11Allocator</a> allocator,
176
 
                                                         <a
177
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
178
 
>GCancellable</a> *cancellable,
179
 
                                                         <a
180
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
181
 
>gsize</a> *n_data,
182
 
                                                         <a
183
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
184
 
>GError</a> **err);
185
 
void                <a class="link" href="gp11-gp11-object.html#gp11-object-get-data-async" title="gp11_object_get_data_async ()">gp11_object_get_data_async</a>          (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
186
 
                                                         <a
187
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
188
 
>gulong</a> attr_type,
189
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()">GP11Allocator</a> allocator,
190
 
                                                         <a
191
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
192
 
>GCancellable</a> *cancellable,
193
 
                                                         <a
194
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
195
 
>GAsyncReadyCallback</a> callback,
196
 
                                                         <a
197
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
198
 
>gpointer</a> user_data);
199
 
<a
200
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
201
 
>gpointer</a>            <a class="link" href="gp11-gp11-object.html#gp11-object-get-data-finish" title="gp11_object_get_data_finish ()">gp11_object_get_data_finish</a>         (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
202
 
                                                         <a
203
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
204
 
>GAsyncResult</a> *result,
205
 
                                                         <a
206
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
207
 
>gsize</a> *n_data,
208
 
                                                         <a
209
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
210
 
>GError</a> **err);
 
45
<a name="GP11Object"></a><pre class="synopsis">                    <a class="link" href="gp11-gp11-object.html#GP11Object-struct" title="GP11Object">GP11Object</a>;
 
46
<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a>*         <a class="link" href="gp11-gp11-object.html#gp11-object-from-handle" title="gp11_object_from_handle ()">gp11_object_from_handle</a>             (<a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="returnvalue">GP11Slot</span></a> *slot,
 
47
                                                         <span class="returnvalue">CK_OBJECT_HANDLE</span> handle);
 
48
<span class="returnvalue">GList</span>*              <a class="link" href="gp11-gp11-object.html#gp11-objects-from-handle-array" title="gp11_objects_from_handle_array ()">gp11_objects_from_handle_array</a>      (<a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="returnvalue">GP11Slot</span></a> *slot,
 
49
                                                         <span class="returnvalue">CK_OBJECT_HANDLE_PTR</span> handles,
 
50
                                                         <span class="returnvalue">CK_ULONG</span> n_handles);
 
51
<span class="returnvalue">gboolean</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-equal" title="gp11_object_equal ()">gp11_object_equal</a>                   (<span class="returnvalue">gconstpointer</span> object1,
 
52
                                                         <span class="returnvalue">gconstpointer</span> object2);
 
53
<span class="returnvalue">guint</span>               <a class="link" href="gp11-gp11-object.html#gp11-object-hash" title="gp11_object_hash ()">gp11_object_hash</a>                    (<span class="returnvalue">gconstpointer</span> object);
 
54
<a class="link" href="gp11-gp11-module.html#GP11Module"><span class="returnvalue">GP11Module</span></a>*         <a class="link" href="gp11-gp11-object.html#gp11-object-get-module" title="gp11_object_get_module ()">gp11_object_get_module</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);
 
55
<a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="returnvalue">GP11Slot</span></a>*           <a class="link" href="gp11-gp11-object.html#gp11-object-get-slot" title="gp11_object_get_slot ()">gp11_object_get_slot</a>                (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);
 
56
<span class="returnvalue">CK_OBJECT_HANDLE</span>    <a class="link" href="gp11-gp11-object.html#gp11-object-get-handle" title="gp11_object_get_handle ()">gp11_object_get_handle</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);
 
57
<a class="link" href="gp11-gp11-session.html#GP11Session"><span class="returnvalue">GP11Session</span></a>*        <a class="link" href="gp11-gp11-object.html#gp11-object-get-session" title="gp11_object_get_session ()">gp11_object_get_session</a>             (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);
 
58
<span class="returnvalue">void</span>                <a class="link" href="gp11-gp11-object.html#gp11-object-set-session" title="gp11_object_set_session ()">gp11_object_set_session</a>             (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
59
                                                         <a class="link" href="gp11-gp11-session.html#GP11Session"><span class="returnvalue">GP11Session</span></a> *session);
 
60
<span class="returnvalue">gboolean</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-destroy" title="gp11_object_destroy ()">gp11_object_destroy</a>                 (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
61
                                                         <span class="returnvalue">GError</span> **err);
 
62
<span class="returnvalue">gboolean</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-destroy-full" title="gp11_object_destroy_full ()">gp11_object_destroy_full</a>            (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
63
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
64
                                                         <span class="returnvalue">GError</span> **err);
 
65
<span class="returnvalue">void</span>                <a class="link" href="gp11-gp11-object.html#gp11-object-destroy-async" title="gp11_object_destroy_async ()">gp11_object_destroy_async</a>           (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
66
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
67
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
68
                                                         <span class="returnvalue">gpointer</span> user_data);
 
69
<span class="returnvalue">gboolean</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-destroy-finish" title="gp11_object_destroy_finish ()">gp11_object_destroy_finish</a>          (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
70
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
71
                                                         <span class="returnvalue">GError</span> **err);
 
72
<span class="returnvalue">gboolean</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-set" title="gp11_object_set ()">gp11_object_set</a>                     (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
73
                                                         <span class="returnvalue">GError</span> **err,
 
74
                                                         ...);
 
75
<span class="returnvalue">void</span>                <a class="link" href="gp11-gp11-object.html#gp11-object-set-async" title="gp11_object_set_async ()">gp11_object_set_async</a>               (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
76
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a> *attrs,
 
77
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
78
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
79
                                                         <span class="returnvalue">gpointer</span> user_data);
 
80
<span class="returnvalue">gboolean</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-set-finish" title="gp11_object_set_finish ()">gp11_object_set_finish</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
81
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
82
                                                         <span class="returnvalue">GError</span> **err);
 
83
<a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a>*     <a class="link" href="gp11-gp11-object.html#gp11-object-get" title="gp11_object_get ()">gp11_object_get</a>                     (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
84
                                                         <span class="returnvalue">GError</span> **err,
 
85
                                                         ...);
 
86
<span class="returnvalue">void</span>                <a class="link" href="gp11-gp11-object.html#gp11-object-get-async" title="gp11_object_get_async ()">gp11_object_get_async</a>               (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
87
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a> *attrs,
 
88
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
89
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
90
                                                         <span class="returnvalue">gpointer</span> user_data);
 
91
<a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a>*     <a class="link" href="gp11-gp11-object.html#gp11-object-get-finish" title="gp11_object_get_finish ()">gp11_object_get_finish</a>              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
92
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
93
                                                         <span class="returnvalue">GError</span> **err);
 
94
<span class="returnvalue">gpointer</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-get-data" title="gp11_object_get_data ()">gp11_object_get_data</a>                (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
95
                                                         <span class="returnvalue">gulong</span> attr_type,
 
96
                                                         <span class="returnvalue">gsize</span> *n_data,
 
97
                                                         <span class="returnvalue">GError</span> **err);
 
98
<span class="returnvalue">gpointer</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-get-data-full" title="gp11_object_get_data_full ()">gp11_object_get_data_full</a>           (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
99
                                                         <span class="returnvalue">gulong</span> attr_type,
 
100
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()"><span class="returnvalue">GP11Allocator</span></a> allocator,
 
101
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
102
                                                         <span class="returnvalue">gsize</span> *n_data,
 
103
                                                         <span class="returnvalue">GError</span> **err);
 
104
<span class="returnvalue">void</span>                <a class="link" href="gp11-gp11-object.html#gp11-object-get-data-async" title="gp11_object_get_data_async ()">gp11_object_get_data_async</a>          (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
105
                                                         <span class="returnvalue">gulong</span> attr_type,
 
106
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()"><span class="returnvalue">GP11Allocator</span></a> allocator,
 
107
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
108
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
109
                                                         <span class="returnvalue">gpointer</span> user_data);
 
110
<span class="returnvalue">gpointer</span>            <a class="link" href="gp11-gp11-object.html#gp11-object-get-data-finish" title="gp11_object_get_data_finish ()">gp11_object_get_data_finish</a>         (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
111
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
112
                                                         <span class="returnvalue">gsize</span> *n_data,
 
113
                                                         <span class="returnvalue">GError</span> **err);
211
114
</pre>
212
115
</div>
213
116
<div class="refsect1" title="Object Hierarchy">
214
117
<a name="gp11-gp11-object.object-hierarchy"></a><h2>Object Hierarchy</h2>
215
118
<pre class="synopsis">
216
 
  <a
217
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
218
 
>GObject</a>
 
119
  GObject
219
120
   +----GP11Object
220
121
</pre>
221
122
</div>
222
123
<div class="refsect1" title="Properties">
223
124
<a name="gp11-gp11-object.properties"></a><h2>Properties</h2>
224
125
<pre class="synopsis">
225
 
  "<a class="link" href="gp11-gp11-object.html#GP11Object--handle" title='The "handle" property'>handle</a>"                   <a
226
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
227
 
>gulong</a>                : Read / Write / Construct Only
228
 
  "<a class="link" href="gp11-gp11-object.html#GP11Object--module" title='The "module" property'>module</a>"                   <a class="link" href="gp11-gp11-module.html#GP11Module">GP11Module</a>*           : Read / Write / Construct Only
229
 
  "<a class="link" href="gp11-gp11-object.html#GP11Object--session" title='The "session" property'>session</a>"                  <a class="link" href="gp11-gp11-session.html#GP11Session">GP11Session</a>*          : Read / Write
230
 
  "<a class="link" href="gp11-gp11-object.html#GP11Object--slot" title='The "slot" property'>slot</a>"                     <a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a>*             : Read / Write / Construct Only
 
126
  "<a class="link" href="gp11-gp11-object.html#GP11Object--handle" title='The "handle" property'>handle</a>"                   <span class="type">gulong</span>                : Read / Write / Construct Only
 
127
  "<a class="link" href="gp11-gp11-object.html#GP11Object--module" title='The "module" property'>module</a>"                   <a class="link" href="gp11-gp11-module.html#GP11Module"><span class="type">GP11Module</span></a>*           : Read / Write / Construct Only
 
128
  "<a class="link" href="gp11-gp11-object.html#GP11Object--session" title='The "session" property'>session</a>"                  <a class="link" href="gp11-gp11-session.html#GP11Session"><span class="type">GP11Session</span></a>*          : Read / Write
 
129
  "<a class="link" href="gp11-gp11-object.html#GP11Object--slot" title='The "slot" property'>slot</a>"                     <a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="type">GP11Slot</span></a>*             : Read / Write / Construct Only
231
130
</pre>
232
131
</div>
233
132
<div class="refsect1" title="Description">
235
134
<p>
236
135
A GP11Object holds a handle to a PKCS11 object such as a key or certificate. Token objects
237
136
are stored on the token persistently. Others are transient and are called session objects.</p>
238
 
<p>
239
 
</p>
240
137
</div>
241
138
<div class="refsect1" title="Details">
242
139
<a name="gp11-gp11-object.details"></a><h2>Details</h2>
245
142
<pre class="programlisting">typedef struct _GP11Object GP11Object;</pre>
246
143
<p>
247
144
Represents a PKCS11 object handle such as a key or certifiacte.</p>
248
 
<p>
249
 
</p>
250
145
</div>
251
146
<hr>
252
147
<div class="refsect2" title="gp11_object_from_handle ()">
253
148
<a name="gp11-object-from-handle"></a><h3>gp11_object_from_handle ()</h3>
254
 
<pre class="programlisting"><a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a>*         gp11_object_from_handle             (<a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a> *slot,
255
 
                                                         CK_OBJECT_HANDLE handle);</pre>
 
149
<pre class="programlisting"><a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a>*         gp11_object_from_handle             (<a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="returnvalue">GP11Slot</span></a> *slot,
 
150
                                                         <span class="returnvalue">CK_OBJECT_HANDLE</span> handle);</pre>
256
151
<p>
257
152
Initialize a GP11Object from a raw PKCS<span class="type">11</span> handle. Normally you would use 
258
153
<a class="link" href="gp11-gp11-session.html#gp11-session-create-object" title="gp11_session_create_object ()"><code class="function">gp11_session_create_object()</code></a> or <a class="link" href="gp11-gp11-session.html#gp11-session-find-objects" title="gp11_session_find_objects ()"><code class="function">gp11_session_find_objects()</code></a> to access objects.</p>
259
 
<p>
260
 
</p>
261
154
<div class="variablelist"><table border="0">
262
155
<col align="left" valign="top">
263
156
<tbody>
273
166
</tr>
274
167
<tr>
275
168
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
276
 
<td> The new GP11Object. You should use <a
277
 
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"
278
 
><code class="function">g_object_unref()</code></a> when done with this object.
 
169
<td> The new GP11Object. You should use <a href="/gnome/usr/share/gtk-doc/html/libmissioncontrol-server/libmissioncontrol-server-mcd-debug.html#g-object-unref"><code class="function">g_object_unref()</code></a> when done with this object.
279
170
</td>
280
171
</tr>
281
172
</tbody>
284
175
<hr>
285
176
<div class="refsect2" title="gp11_objects_from_handle_array ()">
286
177
<a name="gp11-objects-from-handle-array"></a><h3>gp11_objects_from_handle_array ()</h3>
287
 
<pre class="programlisting"><a
288
 
href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"
289
 
>GList</a>*              gp11_objects_from_handle_array      (<a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a> *slot,
290
 
                                                         CK_OBJECT_HANDLE_PTR handles,
291
 
                                                         CK_ULONG n_handles);</pre>
 
178
<pre class="programlisting"><span class="returnvalue">GList</span>*              gp11_objects_from_handle_array      (<a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="returnvalue">GP11Slot</span></a> *slot,
 
179
                                                         <span class="returnvalue">CK_OBJECT_HANDLE_PTR</span> handles,
 
180
                                                         <span class="returnvalue">CK_ULONG</span> n_handles);</pre>
292
181
<p>
293
182
Initialize a list of GP11Object from raw PKCS<span class="type">11</span> handles. The handles argument must contain 
294
183
contiguous CK_OBJECT_HANDLE handles in an array.</p>
295
 
<p>
296
 
</p>
297
184
<div class="variablelist"><table border="0">
298
185
<col align="left" valign="top">
299
186
<tbody>
324
211
<hr>
325
212
<div class="refsect2" title="gp11_object_equal ()">
326
213
<a name="gp11-object-equal"></a><h3>gp11_object_equal ()</h3>
327
 
<pre class="programlisting"><a
328
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
329
 
>gboolean</a>            gp11_object_equal                   (<a
330
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"
331
 
>gconstpointer</a> object1,
332
 
                                                         <a
333
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"
334
 
>gconstpointer</a> object2);</pre>
 
214
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gp11_object_equal                   (<span class="returnvalue">gconstpointer</span> object1,
 
215
                                                         <span class="returnvalue">gconstpointer</span> object2);</pre>
335
216
<p>
336
217
Checks equality of two objects. Two GP11Object objects can point to the same 
337
218
underlying PKCS<span class="type">11</span> object.</p>
338
 
<p>
339
 
</p>
340
219
<div class="variablelist"><table border="0">
341
220
<col align="left" valign="top">
342
221
<tbody>
361
240
<hr>
362
241
<div class="refsect2" title="gp11_object_hash ()">
363
242
<a name="gp11-object-hash"></a><h3>gp11_object_hash ()</h3>
364
 
<pre class="programlisting"><a
365
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"
366
 
>guint</a>               gp11_object_hash                    (<a
367
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gconstpointer"
368
 
>gconstpointer</a> object);</pre>
 
243
<pre class="programlisting"><span class="returnvalue">guint</span>               gp11_object_hash                    (<span class="returnvalue">gconstpointer</span> object);</pre>
369
244
<p>
370
245
Create a hash value for the GP11Object. 
371
246
</p>
372
247
<p>
373
248
This function is intended for easily hashing a GP11Object to add to 
374
249
a GHashTable or similar data structure.</p>
375
 
<p>
376
 
</p>
377
250
<div class="variablelist"><table border="0">
378
251
<col align="left" valign="top">
379
252
<tbody>
393
266
<hr>
394
267
<div class="refsect2" title="gp11_object_get_module ()">
395
268
<a name="gp11-object-get-module"></a><h3>gp11_object_get_module ()</h3>
396
 
<pre class="programlisting"><a class="link" href="gp11-gp11-module.html#GP11Module">GP11Module</a>*         gp11_object_get_module              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);</pre>
 
269
<pre class="programlisting"><a class="link" href="gp11-gp11-module.html#GP11Module"><span class="returnvalue">GP11Module</span></a>*         gp11_object_get_module              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);</pre>
397
270
<p>
398
271
Get the PKCS<span class="type">11</span> module to which this object belongs.</p>
399
 
<p>
400
 
</p>
401
272
<div class="variablelist"><table border="0">
402
273
<col align="left" valign="top">
403
274
<tbody>
417
288
<hr>
418
289
<div class="refsect2" title="gp11_object_get_slot ()">
419
290
<a name="gp11-object-get-slot"></a><h3>gp11_object_get_slot ()</h3>
420
 
<pre class="programlisting"><a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a>*           gp11_object_get_slot                (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);</pre>
 
291
<pre class="programlisting"><a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="returnvalue">GP11Slot</span></a>*           gp11_object_get_slot                (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);</pre>
421
292
<p>
422
293
Get the PKCS<span class="type">11</span> slot to which this object belongs.</p>
423
 
<p>
424
 
</p>
425
294
<div class="variablelist"><table border="0">
426
295
<col align="left" valign="top">
427
296
<tbody>
441
310
<hr>
442
311
<div class="refsect2" title="gp11_object_get_handle ()">
443
312
<a name="gp11-object-get-handle"></a><h3>gp11_object_get_handle ()</h3>
444
 
<pre class="programlisting">CK_OBJECT_HANDLE    gp11_object_get_handle              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);</pre>
 
313
<pre class="programlisting"><span class="returnvalue">CK_OBJECT_HANDLE</span>    gp11_object_get_handle              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);</pre>
445
314
<p>
446
315
Get the raw PKCS<span class="type">11</span> handle of a GP11Object.</p>
447
 
<p>
448
 
</p>
449
316
<div class="variablelist"><table border="0">
450
317
<col align="left" valign="top">
451
318
<tbody>
465
332
<hr>
466
333
<div class="refsect2" title="gp11_object_get_session ()">
467
334
<a name="gp11-object-get-session"></a><h3>gp11_object_get_session ()</h3>
468
 
<pre class="programlisting"><a class="link" href="gp11-gp11-session.html#GP11Session">GP11Session</a>*        gp11_object_get_session             (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self);</pre>
 
335
<pre class="programlisting"><a class="link" href="gp11-gp11-session.html#GP11Session"><span class="returnvalue">GP11Session</span></a>*        gp11_object_get_session             (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self);</pre>
469
336
<p>
470
337
Get the PKCS<span class="type">11</span> session assigned to make calls on when operating
471
338
on this object.  
474
341
This will only return a session if it was set explitly on this 
475
342
object. By default an object will open and close sessions 
476
343
appropriate for its calls.</p>
477
 
<p>
478
 
</p>
479
344
<div class="variablelist"><table border="0">
480
345
<col align="left" valign="top">
481
346
<tbody>
495
360
<hr>
496
361
<div class="refsect2" title="gp11_object_set_session ()">
497
362
<a name="gp11-object-set-session"></a><h3>gp11_object_set_session ()</h3>
498
 
<pre class="programlisting">void                gp11_object_set_session             (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
499
 
                                                         <a class="link" href="gp11-gp11-session.html#GP11Session">GP11Session</a> *session);</pre>
 
363
<pre class="programlisting"><span class="returnvalue">void</span>                gp11_object_set_session             (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
364
                                                         <a class="link" href="gp11-gp11-session.html#GP11Session"><span class="returnvalue">GP11Session</span></a> *session);</pre>
500
365
<p>
501
366
Set the PKCS<span class="type">11</span> session assigned to make calls on when operating
502
367
on this object.  
509
374
<p>
510
375
If you assign a read-only session, then calls on this object
511
376
that modify the state of the object will probably fail.</p>
512
 
<p>
513
 
</p>
514
377
<div class="variablelist"><table border="0">
515
378
<col align="left" valign="top">
516
379
<tbody>
530
393
<hr>
531
394
<div class="refsect2" title="gp11_object_destroy ()">
532
395
<a name="gp11-object-destroy"></a><h3>gp11_object_destroy ()</h3>
533
 
<pre class="programlisting"><a
534
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
535
 
>gboolean</a>            gp11_object_destroy                 (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
536
 
                                                         <a
537
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
538
 
>GError</a> **err);</pre>
 
396
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gp11_object_destroy                 (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
397
                                                         <span class="returnvalue">GError</span> **err);</pre>
539
398
<p>
540
399
Destroy a PKCS<span class="type">11</span> object, deleting it from storage or the session.
541
400
This call may block for an indefinite period.</p>
542
 
<p>
543
 
</p>
544
401
<div class="variablelist"><table border="0">
545
402
<col align="left" valign="top">
546
403
<tbody>
565
422
<hr>
566
423
<div class="refsect2" title="gp11_object_destroy_full ()">
567
424
<a name="gp11-object-destroy-full"></a><h3>gp11_object_destroy_full ()</h3>
568
 
<pre class="programlisting"><a
569
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
570
 
>gboolean</a>            gp11_object_destroy_full            (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
571
 
                                                         <a
572
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
573
 
>GCancellable</a> *cancellable,
574
 
                                                         <a
575
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
576
 
>GError</a> **err);</pre>
 
425
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gp11_object_destroy_full            (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
426
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
427
                                                         <span class="returnvalue">GError</span> **err);</pre>
577
428
<p>
578
429
Destroy a PKCS<span class="type">11</span> object, deleting it from storage or the session.
579
430
This call may block for an indefinite period.</p>
580
 
<p>
581
 
</p>
582
431
<div class="variablelist"><table border="0">
583
432
<col align="left" valign="top">
584
433
<tbody>
608
457
<hr>
609
458
<div class="refsect2" title="gp11_object_destroy_async ()">
610
459
<a name="gp11-object-destroy-async"></a><h3>gp11_object_destroy_async ()</h3>
611
 
<pre class="programlisting">void                gp11_object_destroy_async           (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
612
 
                                                         <a
613
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
614
 
>GCancellable</a> *cancellable,
615
 
                                                         <a
616
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
617
 
>GAsyncReadyCallback</a> callback,
618
 
                                                         <a
619
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
620
 
>gpointer</a> user_data);</pre>
 
460
<pre class="programlisting"><span class="returnvalue">void</span>                gp11_object_destroy_async           (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
461
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
462
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
463
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
621
464
<p>
622
465
Destroy a PKCS<span class="type">11</span> object, deleting it from storage or the session.
623
466
This call will return immediately and complete asynchronously.</p>
624
 
<p>
625
 
</p>
626
467
<div class="variablelist"><table border="0">
627
468
<col align="left" valign="top">
628
469
<tbody>
652
493
<hr>
653
494
<div class="refsect2" title="gp11_object_destroy_finish ()">
654
495
<a name="gp11-object-destroy-finish"></a><h3>gp11_object_destroy_finish ()</h3>
655
 
<pre class="programlisting"><a
656
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
657
 
>gboolean</a>            gp11_object_destroy_finish          (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
658
 
                                                         <a
659
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
660
 
>GAsyncResult</a> *result,
661
 
                                                         <a
662
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
663
 
>GError</a> **err);</pre>
 
496
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gp11_object_destroy_finish          (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
497
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
498
                                                         <span class="returnvalue">GError</span> **err);</pre>
664
499
<p>
665
500
Get the status of the operation to destroy a PKCS<span class="type">11</span> object, begun with 
666
501
<a class="link" href="gp11-gp11-object.html#gp11-object-destroy-async" title="gp11_object_destroy_async ()"><code class="function">gp11_object_destroy_async()</code></a>.</p>
667
 
<p>
668
 
</p>
669
502
<div class="variablelist"><table border="0">
670
503
<col align="left" valign="top">
671
504
<tbody>
695
528
<hr>
696
529
<div class="refsect2" title="gp11_object_set ()">
697
530
<a name="gp11-object-set"></a><h3>gp11_object_set ()</h3>
698
 
<pre class="programlisting"><a
699
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
700
 
>gboolean</a>            gp11_object_set                     (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
701
 
                                                         <a
702
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
703
 
>GError</a> **err,
 
531
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gp11_object_set                     (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
532
                                                         <span class="returnvalue">GError</span> **err,
704
533
                                                         ...);</pre>
705
534
<p>
706
535
Set PKCS<span class="type">11</span> attributes on an object.
734
563
</table></div>
735
564
<p>
736
565
The variable argument list should be terminated with GP11_INVALID.</p>
737
 
<p>
738
 
</p>
739
566
<div class="variablelist"><table border="0">
740
567
<col align="left" valign="top">
741
568
<tbody>
765
592
<hr>
766
593
<div class="refsect2" title="gp11_object_set_async ()">
767
594
<a name="gp11-object-set-async"></a><h3>gp11_object_set_async ()</h3>
768
 
<pre class="programlisting">void                gp11_object_set_async               (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
769
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a> *attrs,
770
 
                                                         <a
771
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
772
 
>GCancellable</a> *cancellable,
773
 
                                                         <a
774
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
775
 
>GAsyncReadyCallback</a> callback,
776
 
                                                         <a
777
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
778
 
>gpointer</a> user_data);</pre>
 
595
<pre class="programlisting"><span class="returnvalue">void</span>                gp11_object_set_async               (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
596
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a> *attrs,
 
597
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
598
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
599
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
779
600
<p>
780
601
Set PKCS<span class="type">11</span> attributes on an object. This call will return 
781
602
immediately and completes asynchronously.</p>
782
 
<p>
783
 
</p>
784
603
<div class="variablelist"><table border="0">
785
604
<col align="left" valign="top">
786
605
<tbody>
815
634
<hr>
816
635
<div class="refsect2" title="gp11_object_set_finish ()">
817
636
<a name="gp11-object-set-finish"></a><h3>gp11_object_set_finish ()</h3>
818
 
<pre class="programlisting"><a
819
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
820
 
>gboolean</a>            gp11_object_set_finish              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
821
 
                                                         <a
822
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
823
 
>GAsyncResult</a> *result,
824
 
                                                         <a
825
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
826
 
>GError</a> **err);</pre>
 
637
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gp11_object_set_finish              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
638
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
639
                                                         <span class="returnvalue">GError</span> **err);</pre>
827
640
<p>
828
641
Get the status of the operation to set attributes on a PKCS<span class="type">11</span> object, 
829
642
begun with <a class="link" href="gp11-gp11-object.html#gp11-object-set-async" title="gp11_object_set_async ()"><code class="function">gp11_object_set_async()</code></a>.</p>
830
 
<p>
831
 
</p>
832
643
<div class="variablelist"><table border="0">
833
644
<col align="left" valign="top">
834
645
<tbody>
858
669
<hr>
859
670
<div class="refsect2" title="gp11_object_get ()">
860
671
<a name="gp11-object-get"></a><h3>gp11_object_get ()</h3>
861
 
<pre class="programlisting"><a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a>*     gp11_object_get                     (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
862
 
                                                         <a
863
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
864
 
>GError</a> **err,
 
672
<pre class="programlisting"><a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a>*     gp11_object_get                     (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
673
                                                         <span class="returnvalue">GError</span> **err,
865
674
                                                         ...);</pre>
866
675
<p>
867
676
Get the specified attributes from the object. This call may
868
677
block for an indefinite period.</p>
869
 
<p>
870
 
</p>
871
678
<div class="variablelist"><table border="0">
872
679
<col align="left" valign="top">
873
680
<tbody>
898
705
<hr>
899
706
<div class="refsect2" title="gp11_object_get_async ()">
900
707
<a name="gp11-object-get-async"></a><h3>gp11_object_get_async ()</h3>
901
 
<pre class="programlisting">void                gp11_object_get_async               (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
902
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a> *attrs,
903
 
                                                         <a
904
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
905
 
>GCancellable</a> *cancellable,
906
 
                                                         <a
907
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
908
 
>GAsyncReadyCallback</a> callback,
909
 
                                                         <a
910
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
911
 
>gpointer</a> user_data);</pre>
 
708
<pre class="programlisting"><span class="returnvalue">void</span>                gp11_object_get_async               (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
709
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a> *attrs,
 
710
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
711
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
712
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
912
713
<p>
913
714
Get the specified attributes from the object. The attributes will be cleared
914
715
of their current values, and new attributes will be stored. The attributes
917
718
</p>
918
719
<p>
919
720
This call returns immediately and completes asynchronously.</p>
920
 
<p>
921
 
</p>
922
721
<div class="variablelist"><table border="0">
923
722
<col align="left" valign="top">
924
723
<tbody>
953
752
<hr>
954
753
<div class="refsect2" title="gp11_object_get_finish ()">
955
754
<a name="gp11-object-get-finish"></a><h3>gp11_object_get_finish ()</h3>
956
 
<pre class="programlisting"><a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes">GP11Attributes</a>*     gp11_object_get_finish              (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
957
 
                                                         <a
958
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
959
 
>GAsyncResult</a> *result,
960
 
                                                         <a
961
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
962
 
>GError</a> **err);</pre>
 
755
<pre class="programlisting"><a class="link" href="gp11-gp11-attributes.html#GP11Attributes" title="GP11Attributes"><span class="returnvalue">GP11Attributes</span></a>*     gp11_object_get_finish              (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
756
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
757
                                                         <span class="returnvalue">GError</span> **err);</pre>
963
758
<p>
964
759
Get the result of a get operation and return specified attributes from 
965
760
the object. 
966
761
</p>
967
762
<p>
968
763
No extra references are added to the returned attributes pointer.</p>
969
 
<p>
970
 
</p>
971
764
<div class="variablelist"><table border="0">
972
765
<col align="left" valign="top">
973
766
<tbody>
998
791
<hr>
999
792
<div class="refsect2" title="gp11_object_get_data ()">
1000
793
<a name="gp11-object-get-data"></a><h3>gp11_object_get_data ()</h3>
1001
 
<pre class="programlisting"><a
1002
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1003
 
>gpointer</a>            gp11_object_get_data                (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
1004
 
                                                         <a
1005
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
1006
 
>gulong</a> attr_type,
1007
 
                                                         <a
1008
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
1009
 
>gsize</a> *n_data,
1010
 
                                                         <a
1011
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1012
 
>GError</a> **err);</pre>
 
794
<pre class="programlisting"><span class="returnvalue">gpointer</span>            gp11_object_get_data                (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
795
                                                         <span class="returnvalue">gulong</span> attr_type,
 
796
                                                         <span class="returnvalue">gsize</span> *n_data,
 
797
                                                         <span class="returnvalue">GError</span> **err);</pre>
1013
798
<p>
1014
799
Get the data for the specified attribute from the object. For convenience
1015
800
the returned data has a null terminator.
1016
801
</p>
1017
802
<p>
1018
803
This call may block for an indefinite period.</p>
1019
 
<p>
1020
 
</p>
1021
804
<div class="variablelist"><table border="0">
1022
805
<col align="left" valign="top">
1023
806
<tbody>
1052
835
<hr>
1053
836
<div class="refsect2" title="gp11_object_get_data_full ()">
1054
837
<a name="gp11-object-get-data-full"></a><h3>gp11_object_get_data_full ()</h3>
1055
 
<pre class="programlisting"><a
1056
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1057
 
>gpointer</a>            gp11_object_get_data_full           (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
1058
 
                                                         <a
1059
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
1060
 
>gulong</a> attr_type,
1061
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()">GP11Allocator</a> allocator,
1062
 
                                                         <a
1063
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
1064
 
>GCancellable</a> *cancellable,
1065
 
                                                         <a
1066
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
1067
 
>gsize</a> *n_data,
1068
 
                                                         <a
1069
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1070
 
>GError</a> **err);</pre>
 
838
<pre class="programlisting"><span class="returnvalue">gpointer</span>            gp11_object_get_data_full           (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
839
                                                         <span class="returnvalue">gulong</span> attr_type,
 
840
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()"><span class="returnvalue">GP11Allocator</span></a> allocator,
 
841
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
842
                                                         <span class="returnvalue">gsize</span> *n_data,
 
843
                                                         <span class="returnvalue">GError</span> **err);</pre>
1071
844
<p>
1072
845
Get the data for the specified attribute from the object. For convenience
1073
846
the returned data has an extra null terminator, not included in the returned length.
1074
847
</p>
1075
848
<p>
1076
849
This call may block for an indefinite period.</p>
1077
 
<p>
1078
 
</p>
1079
850
<div class="variablelist"><table border="0">
1080
851
<col align="left" valign="top">
1081
852
<tbody>
1120
891
<hr>
1121
892
<div class="refsect2" title="gp11_object_get_data_async ()">
1122
893
<a name="gp11-object-get-data-async"></a><h3>gp11_object_get_data_async ()</h3>
1123
 
<pre class="programlisting">void                gp11_object_get_data_async          (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
1124
 
                                                         <a
1125
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
1126
 
>gulong</a> attr_type,
1127
 
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()">GP11Allocator</a> allocator,
1128
 
                                                         <a
1129
 
href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"
1130
 
>GCancellable</a> *cancellable,
1131
 
                                                         <a
1132
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"
1133
 
>GAsyncReadyCallback</a> callback,
1134
 
                                                         <a
1135
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1136
 
>gpointer</a> user_data);</pre>
 
894
<pre class="programlisting"><span class="returnvalue">void</span>                gp11_object_get_data_async          (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
895
                                                         <span class="returnvalue">gulong</span> attr_type,
 
896
                                                         <a class="link" href="gp11-gp11-attributes.html#GP11Allocator" title="GP11Allocator ()"><span class="returnvalue">GP11Allocator</span></a> allocator,
 
897
                                                         <span class="returnvalue">GCancellable</span> *cancellable,
 
898
                                                         <span class="returnvalue">GAsyncReadyCallback</span> callback,
 
899
                                                         <span class="returnvalue">gpointer</span> user_data);</pre>
1137
900
<p>
1138
901
Get the data for the specified attribute from the object.
1139
902
</p>
1140
903
<p>
1141
904
This call will return immediately and complete asynchronously.</p>
1142
 
<p>
1143
 
</p>
1144
905
<div class="variablelist"><table border="0">
1145
906
<col align="left" valign="top">
1146
907
<tbody>
1180
941
<hr>
1181
942
<div class="refsect2" title="gp11_object_get_data_finish ()">
1182
943
<a name="gp11-object-get-data-finish"></a><h3>gp11_object_get_data_finish ()</h3>
1183
 
<pre class="programlisting"><a
1184
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
1185
 
>gpointer</a>            gp11_object_get_data_finish         (<a class="link" href="gp11-gp11-object.html#GP11Object">GP11Object</a> *self,
1186
 
                                                         <a
1187
 
href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"
1188
 
>GAsyncResult</a> *result,
1189
 
                                                         <a
1190
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gsize"
1191
 
>gsize</a> *n_data,
1192
 
                                                         <a
1193
 
href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"
1194
 
>GError</a> **err);</pre>
 
944
<pre class="programlisting"><span class="returnvalue">gpointer</span>            gp11_object_get_data_finish         (<a class="link" href="gp11-gp11-object.html#GP11Object"><span class="returnvalue">GP11Object</span></a> *self,
 
945
                                                         <span class="returnvalue">GAsyncResult</span> *result,
 
946
                                                         <span class="returnvalue">gsize</span> *n_data,
 
947
                                                         <span class="returnvalue">GError</span> **err);</pre>
1195
948
<p>
1196
949
Get the result of an operation to get attribute data from
1197
950
an object. For convenience the returned data has an extra null terminator,
1198
951
not included in the returned length.</p>
1199
 
<p>
1200
 
</p>
1201
952
<div class="variablelist"><table border="0">
1202
953
<col align="left" valign="top">
1203
954
<tbody>
1234
985
<a name="gp11-gp11-object.property-details"></a><h2>Property Details</h2>
1235
986
<div class="refsect2" title='The "handle" property'>
1236
987
<a name="GP11Object--handle"></a><h3>The <code class="literal">"handle"</code> property</h3>
1237
 
<pre class="programlisting">  "handle"                   <a
1238
 
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gulong"
1239
 
>gulong</a>                : Read / Write / Construct Only</pre>
 
988
<pre class="programlisting">  "handle"                   <span class="type">gulong</span>                : Read / Write / Construct Only</pre>
1240
989
<p>
1241
990
The raw PKCS11 handle for this object.</p>
1242
 
<p>
1243
 
</p>
1244
991
</div>
1245
992
<hr>
1246
993
<div class="refsect2" title='The "module" property'>
1247
994
<a name="GP11Object--module"></a><h3>The <code class="literal">"module"</code> property</h3>
1248
 
<pre class="programlisting">  "module"                   <a class="link" href="gp11-gp11-module.html#GP11Module">GP11Module</a>*           : Read / Write / Construct Only</pre>
 
995
<pre class="programlisting">  "module"                   <a class="link" href="gp11-gp11-module.html#GP11Module"><span class="type">GP11Module</span></a>*           : Read / Write / Construct Only</pre>
1249
996
<p>
1250
997
The GP11Module that this object belongs to.</p>
1251
 
<p>
1252
 
</p>
1253
998
</div>
1254
999
<hr>
1255
1000
<div class="refsect2" title='The "session" property'>
1256
1001
<a name="GP11Object--session"></a><h3>The <code class="literal">"session"</code> property</h3>
1257
 
<pre class="programlisting">  "session"                  <a class="link" href="gp11-gp11-session.html#GP11Session">GP11Session</a>*          : Read / Write</pre>
 
1002
<pre class="programlisting">  "session"                  <a class="link" href="gp11-gp11-session.html#GP11Session"><span class="type">GP11Session</span></a>*          : Read / Write</pre>
1258
1003
<p>
1259
1004
The PKCS11 session to make calls on when this object needs to
1260
1005
perform operations on itself. 
1262
1007
<p>
1263
1008
If this is NULL then a new session is opened for each operation, 
1264
1009
such as <a class="link" href="gp11-gp11-object.html#gp11-object-get" title="gp11_object_get ()"><code class="function">gp11_object_get()</code></a>, <a class="link" href="gp11-gp11-object.html#gp11-object-set" title="gp11_object_set ()"><code class="function">gp11_object_set()</code></a> or <a class="link" href="gp11-gp11-object.html#gp11-object-destroy" title="gp11_object_destroy ()"><code class="function">gp11_object_destroy()</code></a>.</p>
1265
 
<p>
1266
 
</p>
1267
1010
</div>
1268
1011
<hr>
1269
1012
<div class="refsect2" title='The "slot" property'>
1270
1013
<a name="GP11Object--slot"></a><h3>The <code class="literal">"slot"</code> property</h3>
1271
 
<pre class="programlisting">  "slot"                     <a class="link" href="gp11-gp11-slot.html#GP11Slot">GP11Slot</a>*             : Read / Write / Construct Only</pre>
 
1014
<pre class="programlisting">  "slot"                     <a class="link" href="gp11-gp11-slot.html#GP11Slot"><span class="type">GP11Slot</span></a>*             : Read / Write / Construct Only</pre>
1272
1015
<p>
1273
1016
The GP11Slot that this object belongs to. 
1274
1017
</p>
1275
1018
<p>
1276
1019
If this is a token object then it will be stored on the token in this slot.
1277
1020
If this is a session object, then it belongs to a session opened on this slot.</p>
1278
 
<p>
1279
 
</p>
1280
1021
</div>
1281
1022
</div>
1282
1023
</div>
1283
1024
<div class="footer">
1284
1025
<hr>
1285
 
          Generated by GTK-Doc V1.11</div>
 
1026
          Generated by GTK-Doc V1.14</div>
1286
1027
</body>
1287
 
</html>
 
1028
</html>
 
 
b'\\ No newline at end of file'