|  |  |  | GMime 2.4 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | ||||
GMimeMultipartEncrypted; GMimeMultipartEncrypted * g_mime_multipart_encrypted_new (void); int g_mime_multipart_encrypted_encrypt (GMimeMultipartEncrypted *mpe,GMimeObject *content,GMimeCipherContext *ctx,gboolean sign,const char *userid,GPtrArray *recipients,GError **err); GMimeObject * g_mime_multipart_encrypted_decrypt (GMimeMultipartEncrypted *mpe,GMimeCipherContext *ctx,GError **err); const GMimeSignatureValidity * g_mime_multipart_encrypted_get_signature_validity (GMimeMultipartEncrypted *mpe);
A GMimeMultipartEncrypted part is a special subclass of GMimeMultipart to make it easier to manipulate the multipart/encrypted MIME type.
typedef struct _GMimeMultipartEncrypted GMimeMultipartEncrypted;
A multipart/encrypted MIME part.
GMimeMultipartEncrypted * g_mime_multipart_encrypted_new
                                                        (void);
Creates a new MIME multipart/encrypted object.
| Returns : | an empty MIME multipart/encrypted object. | 
int g_mime_multipart_encrypted_encrypt (GMimeMultipartEncrypted *mpe,GMimeObject *content,GMimeCipherContext *ctx,gboolean sign,const char *userid,GPtrArray *recipients,GError **err);
Attempts to encrypt (and conditionally sign) the content MIME part
to the public keys of recipients using the ctx encryption
context. If successful, the encrypted GMimeObject is set as the
encrypted part of the multipart/encrypted object mpe.
| 
 | multipart/encrypted object | 
| 
 | MIME part to encrypt | 
| 
 | encryption context | 
| 
 | TRUEif the content should also be signed orFALSEotherwise | 
| 
 | user id to use for signing (only used if signisTRUE) | 
| 
 | an array of recipients to encrypt to | 
| 
 | a GError | 
| Returns : | 0on success or-1on fail. If the encryption fails, an
exception will be set onerrto provide information as to why the
failure occured. | 
GMimeObject * g_mime_multipart_encrypted_decrypt (GMimeMultipartEncrypted *mpe,GMimeCipherContext *ctx,GError **err);
Attempts to decrypt the encrypted MIME part contained within the
multipart/encrypted object mpe using the ctx decryption
context.
For information regarding the signature status (in cases where the
MIME part was both encrypted and signed), you may wish to check the
results of g_mime_multipart_encrypted_get_signature_validity().
| 
 | multipart/encrypted object | 
| 
 | decryption context | 
| 
 | a GError | 
| Returns : | the decrypted MIME part on success or NULLon fail. If
the decryption fails, an exception will be set onerrto provide
information as to why the failure occured.
Note: On success, the decrypted MIME part is cached internally and
so the returned GMimeObject must NOT be unreffed. | 
const GMimeSignatureValidity * g_mime_multipart_encrypted_get_signature_validity
                                                        (GMimeMultipartEncrypted *mpe);
Gets the signature validity of the encrypted MIME part.
Note: This is only useful after calling
g_mime_multipart_encrypted_decrypt().
| 
 | a GMimeMultipartEncrypted | 
| Returns : | a GMimeSignatureValidity. |