~ubuntu-branches/ubuntu/vivid/glib2.0/vivid-proposed : revision 203

91

</tr>

92

<tr>

93

94

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

94

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *

95

</td>

96

97

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificates-issued-by" title="g_tls_database_lookup_certificates_issued_by ()">g_tls_database_lookup_certificates_issued_by</a> ()

107

</tr>

108

<tr>

109

110

<a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

110

<a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *

111

</td>

112

113

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificates-issued-by-finish" title="g_tls_database_lookup_certificates_issued_by_finish ()">g_tls_database_lookup_certificates_issued_by_finish</a> ()

115

</tr>

116

<tr>

117

118

<a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *

118

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *

119

</td>

120

121

<a class="link" href="GTlsDatabase.html#g-tls-database-create-certificate-handle" title="g_tls_database_create_certificate_handle ()">g_tls_database_create_certificate_handle</a> ()

181

</div>

182

183

<a name="GTlsDatabase.object-hierarchy"></a><h2>Object Hierarchy</h2>

184

<pre class="screen"> <a href="../gobject/gobject-The-Base-Object-Type.html#GObject">GObject</a>

184

<pre class="screen"> <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

185

╰── GTlsDatabase

186

</pre>

187

</div>

211

<pre class="programlisting"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags">GTlsCertificateFlags</a>

212

g_tls_database_verify_chain (<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

213

<code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a> *chain</code>,

214

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *purpose</code>,

214

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *purpose</code>,

215

<code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable">GSocketConnectable</a> *identity</code>,

216

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

217

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseVerifyFlags" title="enum GTlsDatabaseVerifyFlags">GTlsDatabaseVerifyFlags</a> flags</code>,

218

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

219

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

219

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

220

Verify's a certificate chain after looking up and adding any missing

221

certificates to the chain.

222

<code>chain</code>

284

</tr>

285

<tr>

286

<td class="parameter_name">cancellable</td>

287

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

287

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

288

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

289

</tr>

290

<tr>

291

<td class="parameter_name">error</td>

292

<td class="parameter_description"> a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

292

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

293

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

294

</tr>

295

</tbody>

309

<pre class="programlisting">void

310

g_tls_database_verify_chain_async (<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

311

<code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a> *chain</code>,

312

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *purpose</code>,

312

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *purpose</code>,

313

<code><a class="link" href="GSocketConnectable.html" title="GSocketConnectable">GSocketConnectable</a> *identity</code>,

314

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

315

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseVerifyFlags" title="enum GTlsDatabaseVerifyFlags">GTlsDatabaseVerifyFlags</a> flags</code>,

316

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

317

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

318

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

318

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

319

Asynchronously verify's a certificate chain after looking up and adding

320

any missing certificates to the chain. See <a class="link" href="GTlsDatabase.html#g-tls-database-verify-chain" title="g_tls_database_verify_chain ()"><code class="function">g_tls_database_verify_chain()</code></a>

321

for more information.

360

</tr>

361

<tr>

362

<td class="parameter_name">cancellable</td>

363

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

363

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

364

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

365

</tr>

366

<tr>

384

<pre class="programlisting"><a class="link" href="gio-TLS-Overview.html#GTlsCertificateFlags" title="enum GTlsCertificateFlags">GTlsCertificateFlags</a>

385

g_tls_database_verify_chain_finish (<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

386

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

387

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

387

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

388

Finish an asynchronous verify chain operation. See

389

<a class="link" href="GTlsDatabase.html#g-tls-database-verify-chain" title="g_tls_database_verify_chain ()"><code class="function">g_tls_database_verify_chain()</code></a> for more information. *

390

408

</tr>

409

<tr>

410

<td class="parameter_name">error</td>

411

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

411

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

412

413

</tr>

414

</tbody>

432

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

433

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseLookupFlags" title="enum GTlsDatabaseLookupFlags">GTlsDatabaseLookupFlags</a> flags</code>,

434

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

435

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

435

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

436

Lookup the issuer of <code>certificate</code>

437

in the database.

438

The <code class="literal">issuer</code> property

472

</tr>

473

<tr>

474

<td class="parameter_name">cancellable</td>

475

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

475

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

476

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

477

</tr>

478

<tr>

479

<td class="parameter_name">error</td>

480

<td class="parameter_description"> a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

480

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

481

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

482

</tr>

483

</tbody>

486

487

<a name="id-1.4.15.8.9.5.8"></a><h4>Returns</h4>

488

a newly allocated issuer <a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a>,

489

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

489

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

490

[<acronym title="Free data after the code is done.">transfer full</acronym>]

491

</div>

492

Since 2.30

502

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseLookupFlags" title="enum GTlsDatabaseLookupFlags">GTlsDatabaseLookupFlags</a> flags</code>,

503

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

504

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

505

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

505

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

506

Asynchronously lookup the issuer of <code>certificate</code>

507

in the database. See

508

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificate-issuer" title="g_tls_database_lookup_certificate_issuer ()"><code class="function">g_tls_database_lookup_certificate_issuer()</code></a> for more information.

537

</tr>

538

<tr>

539

<td class="parameter_name">cancellable</td>

540

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

540

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

541

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

542

</tr>

543

<tr>

562

g_tls_database_lookup_certificate_issuer_finish

563

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

564

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

565

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

565

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

566

Finish an asynchronous lookup issuer operation. See

567

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificate-issuer" title="g_tls_database_lookup_certificate_issuer ()"><code class="function">g_tls_database_lookup_certificate_issuer()</code></a> for more information.

568

586

</tr>

587

<tr>

588

<td class="parameter_name">error</td>

589

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

589

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

590

591

</tr>

592

</tbody>

595

596

<a name="id-1.4.15.8.9.7.6"></a><h4>Returns</h4>

597

a newly allocated issuer <a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a>,

598

or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

598

or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

599

[<acronym title="Free data after the code is done.">transfer full</acronym>]

600

</div>

601

Since 2.30

603

<hr>

604

605

<a name="g-tls-database-lookup-certificates-issued-by"></a><h3>g_tls_database_lookup_certificates_issued_by ()</h3>

606

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

606

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *

607

g_tls_database_lookup_certificates_issued_by

608

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

609

<code><a href="../glib/glib-Byte-Arrays.html#GByteArray">GByteArray</a> *issuer_raw_dn</code>,

609

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray">GByteArray</a> *issuer_raw_dn</code>,

610

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

611

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseLookupFlags" title="enum GTlsDatabaseLookupFlags">GTlsDatabaseLookupFlags</a> flags</code>,

612

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

613

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

613

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

614

Lookup certificates issued by this issuer in the database.

615

This function can block, use <a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificates-issued-by-async" title="g_tls_database_lookup_certificates_issued_by_async ()"><code class="function">g_tls_database_lookup_certificates_issued_by_async()</code></a> to perform

616

the lookup operation asynchronously.

630

</tr>

631

<tr>

632

<td class="parameter_name">issuer_raw_dn</td>

633

<td class="parameter_description">a <a href="../glib/glib-Byte-Arrays.html#GByteArray">GByteArray</a> which holds the DER encoded issuer DN.</td>

633

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray">GByteArray</a> which holds the DER encoded issuer DN.</td>

634

635

</tr>

636

<tr>

645

</tr>

646

<tr>

647

<td class="parameter_name">cancellable</td>

648

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

648

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

649

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

650

</tr>

651

<tr>

652

<td class="parameter_name">error</td>

653

<td class="parameter_description"> a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

653

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

654

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

655

</tr>

656

</tbody>

659

660

<a name="id-1.4.15.8.9.8.7"></a><h4>Returns</h4>

661

a newly allocated list of <a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a>

662

objects. Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on each certificate, and <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> on the release the list.

662

objects. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on each certificate, and <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> on the release the list.

663

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GTlsCertificate]

664

</div>

665

Since 2.30

670

<pre class="programlisting">void

671

g_tls_database_lookup_certificates_issued_by_async

672

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

673

<code><a href="../glib/glib-Byte-Arrays.html#GByteArray">GByteArray</a> *issuer_raw_dn</code>,

673

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray">GByteArray</a> *issuer_raw_dn</code>,

674

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

675

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseLookupFlags" title="enum GTlsDatabaseLookupFlags">GTlsDatabaseLookupFlags</a> flags</code>,

676

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

677

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

678

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

678

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

679

Asynchronously lookup certificates issued by this issuer in the database. See

680

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificates-issued-by" title="g_tls_database_lookup_certificates_issued_by ()"><code class="function">g_tls_database_lookup_certificates_issued_by()</code></a> for more information.

681

The database may choose to hold a reference to the issuer byte array for the duration

697

</tr>

698

<tr>

699

<td class="parameter_name">issuer_raw_dn</td>

700

<td class="parameter_description">a <a href="../glib/glib-Byte-Arrays.html#GByteArray">GByteArray</a> which holds the DER encoded issuer DN.</td>

700

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Byte-Arrays.html#GByteArray">GByteArray</a> which holds the DER encoded issuer DN.</td>

701

702

</tr>

703

<tr>

712

</tr>

713

<tr>

714

<td class="parameter_name">cancellable</td>

715

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

715

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

716

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

717

</tr>

718

<tr>

733

<hr>

734

735

<a name="g-tls-database-lookup-certificates-issued-by-finish"></a><h3>g_tls_database_lookup_certificates_issued_by_finish ()</h3>

736

<pre class="programlisting"><a href="../glib/glib-Doubly-Linked-Lists.html#GList">GList</a> *

736

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList">GList</a> *

737

g_tls_database_lookup_certificates_issued_by_finish

738

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

739

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

740

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

740

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

741

Finish an asynchronous lookup of certificates. See

742

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificates-issued-by" title="g_tls_database_lookup_certificates_issued_by ()"><code class="function">g_tls_database_lookup_certificates_issued_by()</code></a> for more information.

743

761

</tr>

762

<tr>

763

<td class="parameter_name">error</td>

764

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

764

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

765

766

</tr>

767

</tbody>

770

771

<a name="id-1.4.15.8.9.10.6"></a><h4>Returns</h4>

772

a newly allocated list of <a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a>

773

objects. Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on each certificate, and <a href="../glib/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> on the release the list.

773

objects. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> on each certificate, and <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> on the release the list.

774

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="Generics and defining elements of containers and arrays.">element-type</acronym> GTlsCertificate]

775

</div>

776

Since 2.30

778

<hr>

779

780

<a name="g-tls-database-create-certificate-handle"></a><h3>g_tls_database_create_certificate_handle ()</h3>

781

<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *

781

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *

782

g_tls_database_create_certificate_handle

783

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

784

<code><a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a> *certificate</code>);</pre>

785

Create a handle string for the certificate. The database will only be able

786

to create a handle for certificates that originate from the database. In

787

cases where the database cannot create a handle for a certificate, <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

787

cases where the database cannot create a handle for a certificate, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>

788

will be returned.

789

This handle should be stable across various instances of the application,

790

and between applications. If a certificate is modified in the database,

824

<pre class="programlisting"><a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a> *

825

g_tls_database_lookup_certificate_for_handle

826

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

827

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *handle</code>,

827

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *handle</code>,

828

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

829

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseLookupFlags" title="enum GTlsDatabaseLookupFlags">GTlsDatabaseLookupFlags</a> flags</code>,

830

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

831

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

831

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

832

Lookup a certificate by its handle.

833

The handle should have been created by calling

834

<a class="link" href="GTlsDatabase.html#g-tls-database-create-certificate-handle" title="g_tls_database_create_certificate_handle ()"><code class="function">g_tls_database_create_certificate_handle()</code></a> on a <a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> object of

835

the same TLS backend. The handle is designed to remain valid across

836

instantiations of the database.

837

If the handle is no longer valid, or does not point to a certificate in

838

this database, then <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

838

this database, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

839

This function can block, use <a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificate-for-handle-async" title="g_tls_database_lookup_certificate_for_handle_async ()"><code class="function">g_tls_database_lookup_certificate_for_handle_async()</code></a> to perform

840

the lookup operation asynchronously.

841

869

</tr>

870

<tr>

871

<td class="parameter_name">cancellable</td>

872

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

872

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

873

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

874

</tr>

875

<tr>

876

<td class="parameter_name">error</td>

877

<td class="parameter_description"> a <a href="../glib/glib-Error-Reporting.html#GError">GError</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

877

<td class="parameter_description"> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

878

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

879

</tr>

880

</tbody>

883

884

<a name="id-1.4.15.8.9.12.9"></a><h4>Returns</h4>

885

a newly allocated

886

<a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

886

<a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

887

[<acronym title="Free data after the code is done.">transfer full</acronym>][<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

888

</div>

889

Since 2.30

894

<pre class="programlisting">void

895

g_tls_database_lookup_certificate_for_handle_async

896

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

897

<code>const <a href="../glib/glib-Basic-Types.html#gchar">gchar</a> *handle</code>,

897

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *handle</code>,

898

<code><a class="link" href="GTlsInteraction.html" title="GTlsInteraction">GTlsInteraction</a> *interaction</code>,

899

<code><a class="link" href="GTlsDatabase.html#GTlsDatabaseLookupFlags" title="enum GTlsDatabaseLookupFlags">GTlsDatabaseLookupFlags</a> flags</code>,

900

<code><a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a> *cancellable</code>,

901

<code><a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()">GAsyncReadyCallback</a> callback</code>,

902

<code><a href="../glib/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

902

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data</code>);</pre>

903

Asynchronously lookup a certificate by its handle in the database. See

904

<a class="link" href="GTlsDatabase.html#g-tls-database-lookup-certificate-for-handle" title="g_tls_database_lookup_certificate_for_handle ()"><code class="function">g_tls_database_lookup_certificate_for_handle()</code></a> for more information.

905

933

</tr>

934

<tr>

935

<td class="parameter_name">cancellable</td>

936

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

936

<td class="parameter_description"> a <a class="link" href="GCancellable.html" title="GCancellable">GCancellable</a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </td>

937

<td class="parameter_annotations">[<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]</td>

938

</tr>

939

<tr>

958

g_tls_database_lookup_certificate_for_handle_finish

959

(<code><a class="link" href="GTlsDatabase.html" title="GTlsDatabase">GTlsDatabase</a> *self</code>,

960

<code><a class="link" href="GAsyncResult.html" title="GAsyncResult">GAsyncResult</a> *result</code>,

961

<code><a href="../glib/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

961

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

962

Finish an asynchronous lookup of a certificate by its handle. See

963

<code class="function">g_tls_database_lookup_certificate_handle()</code> for more information.

964

If the handle is no longer valid, or does not point to a certificate in

965

this database, then <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

965

this database, then <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will be returned.

966

967

<a name="id-1.4.15.8.9.14.6"></a><h4>Parameters</h4>

968

984

</tr>

985

<tr>

986

<td class="parameter_name">error</td>

987

<td class="parameter_description">a <a href="../glib/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="../glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

987

<td class="parameter_description">a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> pointer, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a></td>

988

989

</tr>

990

</tbody>

993

994

<a name="id-1.4.15.8.9.14.7"></a><h4>Returns</h4>

995

a newly allocated <a class="link" href="GTlsCertificate.html" title="GTlsCertificate">GTlsCertificate</a> object.

996

Use <a href="../gobject/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

996

Use <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> to release the certificate.

997

[<acronym title="Free data after the code is done.">transfer full</acronym>]

998

</div>

999

Since 2.30