src/message_api.h
author vb
Sat, 03 Jan 2015 16:37:53 +0100
changeset 44 4013b57a6a69
parent 39 66b5cc6cb987
child 48 9ff5d2dfa75a
permissions -rw-r--r--
...
vb@39
     1
#pragma once
vb@39
     2
vb@37
     3
#ifdef __cplusplus
vb@37
     4
extern "C" {
vb@37
     5
#endif
vb@37
     6
vb@37
     7
#include "transport.h"
vb@37
     8
vb@39
     9
vb@44
    10
// mime_encode_parts() - encode message with MIME
vb@44
    11
//  parameters:
vb@44
    12
//      src                 message to encode
vb@44
    13
//      dst                 encoded message or NULL on error
vb@44
    14
//
vb@44
    15
//  return value:
vb@44
    16
//      error status or PEP_STATUS_OK on success
vb@44
    17
//
vb@44
    18
//  caveat:
vb@44
    19
//      message must be unencrypted
vb@44
    20
vb@44
    21
DYNAMIC_API PEP_STATUS mime_encode_parts(const message *src, message **dst);
vb@44
    22
vb@44
    23
vb@44
    24
// mime_decode_parts() - decode MIME message
vb@44
    25
//  parameters:
vb@44
    26
//      src                 message to decode
vb@44
    27
//      dst                 decoded message or NULL on error
vb@44
    28
//
vb@44
    29
//  return value:
vb@44
    30
//      error status or PEP_STATUS_OK on success
vb@44
    31
//
vb@44
    32
//  caveat:
vb@44
    33
//      message must be unencrypted
vb@44
    34
vb@44
    35
DYNAMIC_API PEP_STATUS mime_decode_parts(const message *src, message **dst);
vb@44
    36
vb@44
    37
vb@39
    38
// encrypt_message() - encrypt message in memory
vb@39
    39
//
vb@39
    40
//  parameters:
vb@39
    41
//      session             session handle
vb@39
    42
//      src                 message to encrypt
vb@39
    43
//      extra               extra keys for encryption
vb@39
    44
//      dst                 pointer to encrypted message or NULL on failure
vb@39
    45
//      format              encryption format
vb@39
    46
//
vb@39
    47
//  return value:
vb@39
    48
//      error status or PEP_STATUS_OK on success; PEP_KEY_NOT_FOUND if one
vb@39
    49
//      or more keys couldn't be found, but the message could be encrypted
vb@39
    50
//      with other keys
vb@38
    51
vb@44
    52
DYNAMIC_API PEP_STATUS encrypt_message(
vb@37
    53
        PEP_SESSION session,
vb@37
    54
        const message *src,
vb@37
    55
        stringlist_t *extra,
vb@38
    56
        message **dst,
vb@38
    57
        PEP_enc_format format
vb@37
    58
    );
vb@37
    59
vb@39
    60
vb@39
    61
// decrypt_message() - decrypt message in memory
vb@39
    62
//
vb@39
    63
//  parameters:
vb@39
    64
//      session             session handle
vb@39
    65
//      src                 message to decrypt
vb@39
    66
//      dst                 pointer to decrypted message or NULL on failure
vb@39
    67
//
vb@39
    68
//  return value:
vb@39
    69
//      error status or PEP_STATUS_OK on success
vb@39
    70
vb@44
    71
DYNAMIC_API PEP_STATUS decrypt_message(
vb@37
    72
        PEP_SESSION session,
vb@37
    73
        const message *src,
vb@37
    74
        message **dst
vb@37
    75
    );
vb@37
    76
vb@37
    77
#ifdef __cplusplus
vb@37
    78
}
vb@37
    79
#endif
vb@37
    80