GMimeMultipartSigned

## GMimeMultipartSigned GMimeMultipartSigned — Signed MIME multiparts |

## Synopsis

                        GMimeMultipartSigned;
    GMimeMultipartSigned * g_mime_multipart_signed_new      (void);
    int                 g_mime_multipart_signed_sign        (GMimeMultipartSigned *mps,
                                                             GMimeObject *content,
                                                             GMimeCryptoContext *ctx,
                                                             const char *userid,
                                                             GMimeDigestAlgo digest,
                                                             GError **err);
    GMimeSignatureList * g_mime_multipart_signed_verify     (GMimeMultipartSigned *mps,
                                                             GMimeCryptoContext *ctx,
                                                             GError **err);

## Object Hierarchy

      GObject
       +----GMimeObject
             +----GMimeMultipart
                   +----GMimeMultipartSigned

## Description

A GMimeMultipartSigned part is a special subclass of GMimeMultipart to make it easier to manipulate the multipart/signed MIME type.

## Details

### GMimeMultipartSigned

    typedef struct _GMimeMultipartSigned GMimeMultipartSigned;

A multipart/signed MIME part.

### g_mime_multipart_signed_new ()

    GMimeMultipartSigned * g_mime_multipart_signed_new      (void);

Creates a new MIME multipart/signed object.

Returns : | an empty MIME multipart/signed object.

### g_mime_multipart_signed_sign ()

    int                 g_mime_multipart_signed_sign        (GMimeMultipartSigned *mps,
                                                             GMimeObject *content,
                                                             GMimeCryptoContext *ctx,
                                                             const char *userid,
                                                             GMimeDigestAlgo digest,
                                                             GError **err);

Attempts to sign the `content` MIME part with `userid`'s private key using the `ctx` signing context with the `digest` algorithm. If successful, the signed GMimeObject is set as the signed part of the multipart/signed object `mps`.

`mps` : | multipart/signed object
`content` : | MIME part to sign
`ctx` : | encryption crypto context
`userid` : | user id to sign with
`digest` : | preferred digest algorithm
`err` : | exception
Returns : | `0` on success or `-1` on fail. If the signing fails, an exception will be set on `err` to provide information as to why the failure occured.

### g_mime_multipart_signed_verify ()

    GMimeSignatureList * g_mime_multipart_signed_verify     (GMimeMultipartSigned *mps,
                                                             GMimeCryptoContext *ctx,
                                                             GError **err);

Attempts to verify the signed MIME part contained within the multipart/signed object `mps` using the `ctx` crypto context.

`mps` : | multipart/signed object
`ctx` : | encryption crypto context
`err` : | exception
Returns : | a new GMimeSignatureList object on success or `NULL` on fail. If the verification fails, an exception will be set on `err` to provide information as to why the failure occured.

## See Also

GMimeMultipart