<refentry id="GMimeCertificate">
<refmeta>
<refentrytitle role="top_of_page" id="GMimeCertificate.top_of_page">GMimeCertificate</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  GMIME Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>GMimeCertificate</refname>
<refpurpose>Digital certificates</refpurpose>
</refnamediv>

<refsynopsisdiv id="GMimeCertificate.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>
<anchor id="GMimeCertificateList"/>
<synopsis>enum                <link linkend="GMimePubKeyAlgo">GMimePubKeyAlgo</link>;
enum                <link linkend="GMimeDigestAlgo">GMimeDigestAlgo</link>;
enum                <link linkend="GMimeCertificateTrust">GMimeCertificateTrust</link>;
                    <link linkend="GMimeCertificate-struct">GMimeCertificate</link>;
<link linkend="GMimeCertificate"><returnvalue>GMimeCertificate</returnvalue></link> *  <link linkend="g-mime-certificate-new">g_mime_certificate_new</link>              (<parameter><type>void</type></parameter>);
<link linkend="GMimePubKeyAlgo"><returnvalue>GMimePubKeyAlgo</returnvalue></link>     <link linkend="g-mime-certificate-get-pubkey-algo">g_mime_certificate_get_pubkey_algo</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-pubkey-algo">g_mime_certificate_set_pubkey_algo</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="GMimePubKeyAlgo"><type>GMimePubKeyAlgo</type></link> algo</parameter>);
<link linkend="GMimeDigestAlgo"><returnvalue>GMimeDigestAlgo</returnvalue></link>     <link linkend="g-mime-certificate-get-digest-algo">g_mime_certificate_get_digest_algo</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-digest-algo">g_mime_certificate_set_digest_algo</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="GMimeDigestAlgo"><type>GMimeDigestAlgo</type></link> algo</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-certificate-get-issuer-serial">g_mime_certificate_get_issuer_serial</link>
                                                        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-issuer-serial">g_mime_certificate_set_issuer_serial</link>
                                                        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *issuer_serial</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-certificate-get-issuer-name">g_mime_certificate_get_issuer_name</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-issuer-name">g_mime_certificate_set_issuer_name</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *issuer_name</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-certificate-get-fingerprint">g_mime_certificate_get_fingerprint</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-fingerprint">g_mime_certificate_set_fingerprint</link>  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *fingerprint</parameter>);
<link linkend="time-t"><returnvalue>time_t</returnvalue></link>              <link linkend="g-mime-certificate-get-created">g_mime_certificate_get_created</link>      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-created">g_mime_certificate_set_created</link>      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> created</parameter>);
<link linkend="time-t"><returnvalue>time_t</returnvalue></link>              <link linkend="g-mime-certificate-get-expires">g_mime_certificate_get_expires</link>      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-expires">g_mime_certificate_set_expires</link>      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> expires</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-certificate-get-key-id">g_mime_certificate_get_key_id</link>       (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-key-id">g_mime_certificate_set_key_id</link>       (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *key_id</parameter>);
<link linkend="GMimeCertificateTrust"><returnvalue>GMimeCertificateTrust</returnvalue></link>  <link linkend="g-mime-certificate-get-trust">g_mime_certificate_get_trust</link>     (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-trust">g_mime_certificate_set_trust</link>        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="GMimeCertificateTrust"><type>GMimeCertificateTrust</type></link> trust</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-certificate-get-email">g_mime_certificate_get_email</link>        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-email">g_mime_certificate_set_email</link>        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *email</parameter>);
const <link linkend="char"><returnvalue>char</returnvalue></link> *        <link linkend="g-mime-certificate-get-name">g_mime_certificate_get_name</link>         (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-set-name">g_mime_certificate_set_name</link>         (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);

                    <link linkend="GMimeCertificateList-struct">GMimeCertificateList</link>;
<link linkend="GMimeCertificateList"><returnvalue>GMimeCertificateList</returnvalue></link> * <link linkend="g-mime-certificate-list-new">g_mime_certificate_list_new</link>      (<parameter><type>void</type></parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-certificate-list-length">g_mime_certificate_list_length</link>      (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-list-clear">g_mime_certificate_list_clear</link>       (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-certificate-list-add">g_mime_certificate_list_add</link>         (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-list-insert">g_mime_certificate_list_insert</link>      (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-certificate-list-remove">g_mime_certificate_list_remove</link>      (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-certificate-list-remove-at">g_mime_certificate_list_remove_at</link>   (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);
<link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            <link linkend="g-mime-certificate-list-contains">g_mime_certificate_list_contains</link>    (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="int"><returnvalue>int</returnvalue></link>                 <link linkend="g-mime-certificate-list-index-of">g_mime_certificate_list_index_of</link>    (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
<link linkend="GMimeCertificate"><returnvalue>GMimeCertificate</returnvalue></link> *  <link linkend="g-mime-certificate-list-get-certificate">g_mime_certificate_list_get_certificate</link>
                                                        (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);
<link linkend="void"><returnvalue>void</returnvalue></link>                <link linkend="g-mime-certificate-list-set-certificate">g_mime_certificate_list_set_certificate</link>
                                                        (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);
</synopsis>
</refsynopsisdiv>
<refsect1 id="GMimeCertificate.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----GMimeCertificate
</synopsis>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----GMimeCertificateList
</synopsis>
</refsect1>

<refsect1 id="GMimeCertificate.description" role="desc">
<title role="desc.title">Description</title>
<para>
A <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> is an object containing useful information about a
digital certificate as used in signing and encrypting data.
</para>
</refsect1>
<refsect1 id="GMimeCertificate.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GMimePubKeyAlgo" role="enum">
<title>enum GMimePubKeyAlgo</title>
<indexterm zone="GMimePubKeyAlgo"><primary>GMimePubKeyAlgo</primary></indexterm>
<programlisting>typedef enum {
	GMIME_PUBKEY_ALGO_DEFAULT  = 0,
	GMIME_PUBKEY_ALGO_RSA      = 1,
	GMIME_PUBKEY_ALGO_RSA_E    = 2,
	GMIME_PUBKEY_ALGO_RSA_S    = 3,
	GMIME_PUBKEY_ALGO_ELG_E    = 16,
	GMIME_PUBKEY_ALGO_DSA      = 17,
	GMIME_PUBKEY_ALGO_ELG      = 20
} GMimePubKeyAlgo;
</programlisting>
<para>
A public-key algorithm.
</para><variablelist role="enum">
<varlistentry id="GMIME-PUBKEY-ALGO-DEFAULT:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_DEFAULT</literal></term>
<listitem><simpara>The default public-key algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-PUBKEY-ALGO-RSA:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_RSA</literal></term>
<listitem><simpara>The RSA algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-PUBKEY-ALGO-RSA-E:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_RSA_E</literal></term>
<listitem><simpara>An encryption-only RSA algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-PUBKEY-ALGO-RSA-S:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_RSA_S</literal></term>
<listitem><simpara>A signature-only RSA algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-PUBKEY-ALGO-ELG-E:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_ELG_E</literal></term>
<listitem><simpara>An encryption-only ElGamal algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-PUBKEY-ALGO-DSA:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_DSA</literal></term>
<listitem><simpara>The DSA algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-PUBKEY-ALGO-ELG:CAPS" role="constant">
<term><literal>GMIME_PUBKEY_ALGO_ELG</literal></term>
<listitem><simpara>The ElGamal algorithm.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeDigestAlgo" role="enum">
<title>enum GMimeDigestAlgo</title>
<indexterm zone="GMimeDigestAlgo"><primary>GMimeDigestAlgo</primary></indexterm>
<programlisting>typedef enum {
	GMIME_DIGEST_ALGO_DEFAULT     = 0,
	GMIME_DIGEST_ALGO_MD5         = 1,
	GMIME_DIGEST_ALGO_SHA1        = 2,
	GMIME_DIGEST_ALGO_RIPEMD160   = 3,
	GMIME_DIGEST_ALGO_MD2         = 5,
	GMIME_DIGEST_ALGO_TIGER192    = 6,
	GMIME_DIGEST_ALGO_HAVAL5160   = 7,
	GMIME_DIGEST_ALGO_SHA256      = 8,
	GMIME_DIGEST_ALGO_SHA384      = 9,
	GMIME_DIGEST_ALGO_SHA512      = 10,
	GMIME_DIGEST_ALGO_SHA224      = 11,
	GMIME_DIGEST_ALGO_MD4         = 301,
} GMimeDigestAlgo;
</programlisting>
<para>
A hash algorithm.
</para><variablelist role="enum">
<varlistentry id="GMIME-DIGEST-ALGO-DEFAULT:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_DEFAULT</literal></term>
<listitem><simpara>The default hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-MD5:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_MD5</literal></term>
<listitem><simpara>The MD5 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-SHA1:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_SHA1</literal></term>
<listitem><simpara>The SHA-1 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-RIPEMD160:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_RIPEMD160</literal></term>
<listitem><simpara>The RIPEMD-160 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-MD2:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_MD2</literal></term>
<listitem><simpara>The MD2 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-TIGER192:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_TIGER192</literal></term>
<listitem><simpara>The TIGER-192 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-HAVAL5160:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_HAVAL5160</literal></term>
<listitem><simpara>The HAVAL-5-160 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-SHA256:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_SHA256</literal></term>
<listitem><simpara>The SHA-256 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-SHA384:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_SHA384</literal></term>
<listitem><simpara>The SHA-384 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-SHA512:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_SHA512</literal></term>
<listitem><simpara>The SHA-512 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-SHA224:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_SHA224</literal></term>
<listitem><simpara>The SHA-224 hash algorithm.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-DIGEST-ALGO-MD4:CAPS" role="constant">
<term><literal>GMIME_DIGEST_ALGO_MD4</literal></term>
<listitem><simpara>The MD4 hash algorithm.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeCertificateTrust" role="enum">
<title>enum GMimeCertificateTrust</title>
<indexterm zone="GMimeCertificateTrust"><primary>GMimeCertificateTrust</primary></indexterm>
<programlisting>typedef enum {
	GMIME_CERTIFICATE_TRUST_NONE,
	GMIME_CERTIFICATE_TRUST_NEVER,
	GMIME_CERTIFICATE_TRUST_UNDEFINED,
	GMIME_CERTIFICATE_TRUST_MARGINAL,
	GMIME_CERTIFICATE_TRUST_FULLY,
	GMIME_CERTIFICATE_TRUST_ULTIMATE
} GMimeCertificateTrust;
</programlisting>
<para>
The trust value of a certificate.
</para><variablelist role="enum">
<varlistentry id="GMIME-CERTIFICATE-TRUST-NONE:CAPS" role="constant">
<term><literal>GMIME_CERTIFICATE_TRUST_NONE</literal></term>
<listitem><simpara>No trust assigned.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-CERTIFICATE-TRUST-NEVER:CAPS" role="constant">
<term><literal>GMIME_CERTIFICATE_TRUST_NEVER</literal></term>
<listitem><simpara>Never trust this certificate.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-CERTIFICATE-TRUST-UNDEFINED:CAPS" role="constant">
<term><literal>GMIME_CERTIFICATE_TRUST_UNDEFINED</literal></term>
<listitem><simpara>Undefined trust for this certificate.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-CERTIFICATE-TRUST-MARGINAL:CAPS" role="constant">
<term><literal>GMIME_CERTIFICATE_TRUST_MARGINAL</literal></term>
<listitem><simpara>Trust this certificate maginally.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-CERTIFICATE-TRUST-FULLY:CAPS" role="constant">
<term><literal>GMIME_CERTIFICATE_TRUST_FULLY</literal></term>
<listitem><simpara>Trust this certificate fully.
</simpara></listitem>
</varlistentry>
<varlistentry id="GMIME-CERTIFICATE-TRUST-ULTIMATE:CAPS" role="constant">
<term><literal>GMIME_CERTIFICATE_TRUST_ULTIMATE</literal></term>
<listitem><simpara>Trust this certificate ultimately.
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeCertificate-struct" role="struct">
<title>GMimeCertificate</title>
<indexterm zone="GMimeCertificate-struct"><primary>GMimeCertificate</primary></indexterm>
<programlisting>typedef struct _GMimeCertificate GMimeCertificate;</programlisting>
<para>
An object containing useful information about a certificate.
</para><variablelist role="struct">
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-new" role="function">
<title>g_mime_certificate_new ()</title>
<indexterm zone="g-mime-certificate-new"><primary>g_mime_certificate_new</primary></indexterm>
<programlisting><link linkend="GMimeCertificate"><returnvalue>GMimeCertificate</returnvalue></link> *  g_mime_certificate_new              (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> object.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-pubkey-algo" role="function">
<title>g_mime_certificate_get_pubkey_algo ()</title>
<indexterm zone="g-mime-certificate-get-pubkey-algo"><primary>g_mime_certificate_get_pubkey_algo</primary></indexterm>
<programlisting><link linkend="GMimePubKeyAlgo"><returnvalue>GMimePubKeyAlgo</returnvalue></link>     g_mime_certificate_get_pubkey_algo  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the public-key algorithm used by the certificate.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the public-key algorithm used by the certificate or
<link linkend="GMIME-PUBKEY-ALGO-DEFAULT:CAPS"><type>GMIME_PUBKEY_ALGO_DEFAULT</type></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-pubkey-algo" role="function">
<title>g_mime_certificate_set_pubkey_algo ()</title>
<indexterm zone="g-mime-certificate-set-pubkey-algo"><primary>g_mime_certificate_set_pubkey_algo</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_pubkey_algo  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="GMimePubKeyAlgo"><type>GMimePubKeyAlgo</type></link> algo</parameter>);</programlisting>
<para>
Set the public-key algorithm used by the certificate.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>algo</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimePubKeyAlgo"><type>GMimePubKeyAlgo</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-digest-algo" role="function">
<title>g_mime_certificate_get_digest_algo ()</title>
<indexterm zone="g-mime-certificate-get-digest-algo"><primary>g_mime_certificate_get_digest_algo</primary></indexterm>
<programlisting><link linkend="GMimeDigestAlgo"><returnvalue>GMimeDigestAlgo</returnvalue></link>     g_mime_certificate_get_digest_algo  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the digest algorithm used by the certificate.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the digest algorithm used by the certificate or
<link linkend="GMIME-DIGEST-ALGO-DEFAULT:CAPS"><type>GMIME_DIGEST_ALGO_DEFAULT</type></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-digest-algo" role="function">
<title>g_mime_certificate_set_digest_algo ()</title>
<indexterm zone="g-mime-certificate-set-digest-algo"><primary>g_mime_certificate_set_digest_algo</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_digest_algo  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="GMimeDigestAlgo"><type>GMimeDigestAlgo</type></link> algo</parameter>);</programlisting>
<para>
Set the digest algorithm used by the certificate.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>algo</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeDigestAlgo"><type>GMimeDigestAlgo</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-issuer-serial" role="function">
<title>g_mime_certificate_get_issuer_serial ()</title>
<indexterm zone="g-mime-certificate-get-issuer-serial"><primary>g_mime_certificate_get_issuer_serial</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_certificate_get_issuer_serial
                                                        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate's issuer serial.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate's issuer serial or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-issuer-serial" role="function">
<title>g_mime_certificate_set_issuer_serial ()</title>
<indexterm zone="g-mime-certificate-set-issuer-serial"><primary>g_mime_certificate_set_issuer_serial</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_issuer_serial
                                                        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *issuer_serial</parameter>);</programlisting>
<para>
Set the certificate's issuer serial.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>issuer_serial</parameter>&#160;:</term>
<listitem><simpara>certificate's issuer serial
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-issuer-name" role="function">
<title>g_mime_certificate_get_issuer_name ()</title>
<indexterm zone="g-mime-certificate-get-issuer-name"><primary>g_mime_certificate_get_issuer_name</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_certificate_get_issuer_name  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate's issuer name.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate's issuer name or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-issuer-name" role="function">
<title>g_mime_certificate_set_issuer_name ()</title>
<indexterm zone="g-mime-certificate-set-issuer-name"><primary>g_mime_certificate_set_issuer_name</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_issuer_name  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *issuer_name</parameter>);</programlisting>
<para>
Set the certificate's issuer name.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>issuer_name</parameter>&#160;:</term>
<listitem><simpara>certificate's issuer name
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-fingerprint" role="function">
<title>g_mime_certificate_get_fingerprint ()</title>
<indexterm zone="g-mime-certificate-get-fingerprint"><primary>g_mime_certificate_get_fingerprint</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_certificate_get_fingerprint  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate's key fingerprint.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate's key fingerprint or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-fingerprint" role="function">
<title>g_mime_certificate_set_fingerprint ()</title>
<indexterm zone="g-mime-certificate-set-fingerprint"><primary>g_mime_certificate_set_fingerprint</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_fingerprint  (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *fingerprint</parameter>);</programlisting>
<para>
Set the certificate's key fingerprint.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>fingerprint</parameter>&#160;:</term>
<listitem><simpara>fingerprint string
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-created" role="function">
<title>g_mime_certificate_get_created ()</title>
<indexterm zone="g-mime-certificate-get-created"><primary>g_mime_certificate_get_created</primary></indexterm>
<programlisting><link linkend="time-t"><returnvalue>time_t</returnvalue></link>              g_mime_certificate_get_created      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the creation date of the certificate's key.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the creation date of the certificate's key or <link linkend="1:CAPS"><literal>-1</literal></link> if unknown.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-created" role="function">
<title>g_mime_certificate_set_created ()</title>
<indexterm zone="g-mime-certificate-set-created"><primary>g_mime_certificate_set_created</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_created      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> created</parameter>);</programlisting>
<para>
Set the creation date of the certificate's key.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>created</parameter>&#160;:</term>
<listitem><simpara>creation date
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-expires" role="function">
<title>g_mime_certificate_get_expires ()</title>
<indexterm zone="g-mime-certificate-get-expires"><primary>g_mime_certificate_get_expires</primary></indexterm>
<programlisting><link linkend="time-t"><returnvalue>time_t</returnvalue></link>              g_mime_certificate_get_expires      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the expiration date of the certificate's key.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the expiration date of the certificate's key or <link linkend="1:CAPS"><literal>-1</literal></link> if unknown.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-expires" role="function">
<title>g_mime_certificate_set_expires ()</title>
<indexterm zone="g-mime-certificate-set-expires"><primary>g_mime_certificate_set_expires</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_expires      (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="time-t"><type>time_t</type></link> expires</parameter>);</programlisting>
<para>
Set the expiration date of the certificate's key.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>expires</parameter>&#160;:</term>
<listitem><simpara>expiration date
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-key-id" role="function">
<title>g_mime_certificate_get_key_id ()</title>
<indexterm zone="g-mime-certificate-get-key-id"><primary>g_mime_certificate_get_key_id</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_certificate_get_key_id       (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate's key id.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate's key id or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-key-id" role="function">
<title>g_mime_certificate_set_key_id ()</title>
<indexterm zone="g-mime-certificate-set-key-id"><primary>g_mime_certificate_set_key_id</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_key_id       (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *key_id</parameter>);</programlisting>
<para>
Set the certificate's key id.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>key_id</parameter>&#160;:</term>
<listitem><simpara>key id
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-trust" role="function">
<title>g_mime_certificate_get_trust ()</title>
<indexterm zone="g-mime-certificate-get-trust"><primary>g_mime_certificate_get_trust</primary></indexterm>
<programlisting><link linkend="GMimeCertificateTrust"><returnvalue>GMimeCertificateTrust</returnvalue></link>  g_mime_certificate_get_trust     (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate trust.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate trust.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-trust" role="function">
<title>g_mime_certificate_set_trust ()</title>
<indexterm zone="g-mime-certificate-set-trust"><primary>g_mime_certificate_set_trust</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_trust        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter><link linkend="GMimeCertificateTrust"><type>GMimeCertificateTrust</type></link> trust</parameter>);</programlisting>
<para>
Set the certificate trust.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>trust</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateTrust"><type>GMimeCertificateTrust</type></link> value
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-email" role="function">
<title>g_mime_certificate_get_email ()</title>
<indexterm zone="g-mime-certificate-get-email"><primary>g_mime_certificate_get_email</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_certificate_get_email        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate's email.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate's email or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-email" role="function">
<title>g_mime_certificate_set_email ()</title>
<indexterm zone="g-mime-certificate-set-email"><primary>g_mime_certificate_set_email</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_email        (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *email</parameter>);</programlisting>
<para>
Set the certificate's email.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>email</parameter>&#160;:</term>
<listitem><simpara>certificate's email
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-get-name" role="function">
<title>g_mime_certificate_get_name ()</title>
<indexterm zone="g-mime-certificate-get-name"><primary>g_mime_certificate_get_name</primary></indexterm>
<programlisting>const <link linkend="char"><returnvalue>char</returnvalue></link> *        g_mime_certificate_get_name         (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Get the certificate's name.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the certificate's name or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if unspecified.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-set-name" role="function">
<title>g_mime_certificate_set_name ()</title>
<indexterm zone="g-mime-certificate-set-name"><primary>g_mime_certificate_set_name</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_set_name         (<parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>,
                                                         <parameter>const <link linkend="char"><type>char</type></link> *name</parameter>);</programlisting>
<para>
Set the certificate's name.
</para><variablelist role="params">
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara>certificate's name
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GMimeCertificateList-struct" role="struct">
<title>GMimeCertificateList</title>
<indexterm zone="GMimeCertificateList-struct"><primary>GMimeCertificateList</primary></indexterm>
<programlisting>typedef struct _GMimeCertificateList GMimeCertificateList;</programlisting>
<para>
A collection of <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> objects.
</para><variablelist role="struct">
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-new" role="function">
<title>g_mime_certificate_list_new ()</title>
<indexterm zone="g-mime-certificate-list-new"><primary>g_mime_certificate_list_new</primary></indexterm>
<programlisting><link linkend="GMimeCertificateList"><returnvalue>GMimeCertificateList</returnvalue></link> * g_mime_certificate_list_new      (<parameter><type>void</type></parameter>);</programlisting>
<para>
Creates a new <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-length" role="function">
<title>g_mime_certificate_list_length ()</title>
<indexterm zone="g-mime-certificate-list-length"><primary>g_mime_certificate_list_length</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_certificate_list_length      (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>);</programlisting>
<para>
Gets the length of the list.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the number of <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> objects in the list.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-clear" role="function">
<title>g_mime_certificate_list_clear ()</title>
<indexterm zone="g-mime-certificate-list-clear"><primary>g_mime_certificate_list_clear</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_list_clear       (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>);</programlisting>
<para>
Clears the list of addresses.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-add" role="function">
<title>g_mime_certificate_list_add ()</title>
<indexterm zone="g-mime-certificate-list-add"><primary>g_mime_certificate_list_add</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_certificate_list_add         (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Adds a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> to the <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the added <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-insert" role="function">
<title>g_mime_certificate_list_insert ()</title>
<indexterm zone="g-mime-certificate-list-insert"><primary>g_mime_certificate_list_insert</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_list_insert      (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Inserts a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> into the <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> at the specified
index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index to insert at
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-remove" role="function">
<title>g_mime_certificate_list_remove ()</title>
<indexterm zone="g-mime-certificate-list-remove"><primary>g_mime_certificate_list_remove</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_certificate_list_remove      (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Removes a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> from the <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> was removed or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>
otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-remove-at" role="function">
<title>g_mime_certificate_list_remove_at ()</title>
<indexterm zone="g-mime-certificate-list-remove-at"><primary>g_mime_certificate_list_remove_at</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_certificate_list_remove_at   (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);</programlisting>
<para>
Removes a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> from the <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> at the specified
index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index to remove
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if an <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> was removed or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-contains" role="function">
<title>g_mime_certificate_list_contains ()</title>
<indexterm zone="g-mime-certificate-list-contains"><primary>g_mime_certificate_list_contains</primary></indexterm>
<programlisting><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>            g_mime_certificate_list_contains    (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Checks whether or not the specified <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> is contained within
the <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if the specified <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> is contained within the
specified <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> or <link linkend="FALSE:CAPS"><literal>FALSE</literal></link> otherwise.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-index-of" role="function">
<title>g_mime_certificate_list_index_of ()</title>
<indexterm zone="g-mime-certificate-list-index-of"><primary>g_mime_certificate_list_index_of</primary></indexterm>
<programlisting><link linkend="int"><returnvalue>int</returnvalue></link>                 g_mime_certificate_list_index_of    (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Gets the index of the specified <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> inside the
<link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the index of the requested <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> within the
<link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> or <link linkend="1:CAPS"><literal>-1</literal></link> if it is not contained within the
<link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-get-certificate" role="function">
<title>g_mime_certificate_list_get_certificate ()</title>
<indexterm zone="g-mime-certificate-list-get-certificate"><primary>g_mime_certificate_list_get_certificate</primary></indexterm>
<programlisting><link linkend="GMimeCertificate"><returnvalue>GMimeCertificate</returnvalue></link> *  g_mime_certificate_list_get_certificate
                                                        (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>);</programlisting>
<para>
Gets the <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> at the specified index.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index of <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> to get
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> at the specified index or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if
the index is out of range.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="g-mime-certificate-list-set-certificate" role="function">
<title>g_mime_certificate_list_set_certificate ()</title>
<indexterm zone="g-mime-certificate-list-set-certificate"><primary>g_mime_certificate_list_set_certificate</primary></indexterm>
<programlisting><link linkend="void"><returnvalue>void</returnvalue></link>                g_mime_certificate_list_set_certificate
                                                        (<parameter><link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link> *list</parameter>,
                                                         <parameter><link linkend="int"><type>int</type></link> index</parameter>,
                                                         <parameter><link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> *cert</parameter>);</programlisting>
<para>
Sets the <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> at the specified index to <parameter>cert</parameter>.
</para><variablelist role="params">
<varlistentry><term><parameter>list</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificateList"><type>GMimeCertificateList</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>index</parameter>&#160;:</term>
<listitem><simpara>index of <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link> to set
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cert</parameter>&#160;:</term>
<listitem><simpara>a <link linkend="GMimeCertificate"><type>GMimeCertificate</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>

</refentry>
