epoc32/include/app/miuthdr.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:27:01 +0100
branchSymbian2
changeset 3 e1b950c65cb4
parent 2 epoc32/include/miuthdr.h@2fe1408b6811
child 4 837f303aceeb
permissions -rw-r--r--
Attempt to represent the S^2->S^3 header reorganisation as a series of "hg rename" operations
williamr@2
     1
// Copyright (c) 1998-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2
     2
// All rights reserved.
williamr@2
     3
// This component and the accompanying materials are made available
williamr@2
     4
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2
     5
// which accompanies this distribution, and is available
williamr@2
     6
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2
     7
//
williamr@2
     8
// Initial Contributors:
williamr@2
     9
// Nokia Corporation - initial contribution.
williamr@2
    10
//
williamr@2
    11
// Contributors:
williamr@2
    12
//
williamr@2
    13
// Description:
williamr@2
    14
//
williamr@2
    15
williamr@2
    16
#ifndef __MIUTHDR_H__
williamr@2
    17
#define __MIUTHDR_H__
williamr@2
    18
williamr@2
    19
#include <s32strm.h>
williamr@2
    20
#include <badesca.h>
williamr@2
    21
#include <pop3cmds.h>
williamr@2
    22
#include <msvstd.h>
williamr@2
    23
#include <msvids.h>			// KMsvNullIndexEntryId
williamr@2
    24
#include <miutstd.hrh>			// KUidMsvEmailTextEntryValue
williamr@2
    25
williamr@2
    26
// IMail-specific stream type within an IMail file store for CImHeader
williamr@2
    27
const TUid KUidMsgFileMimeHeader	= {0x1000160F};		// 268441103 decimal
williamr@2
    28
// IMail-specific stream type within an IMail file store for CImMimeHeader
williamr@2
    29
const TUid KUidMsgFileIMailHeader	= {0x100001D8};		// 268435928 decimal
williamr@2
    30
williamr@2
    31
// Identifies which version of CImHeader has been stored in stream
williamr@2
    32
const TUint16 KImHeaderVersion = 2; 
williamr@2
    33
williamr@2
    34
const TUid KUidMsvEmailTextEntry			= {KUidMsvEmailTextEntryValue};
williamr@2
    35
const TUid KUidMsvEmailHtmlEntry			= {KUidMsvEmailHtmlEntryValue};
williamr@2
    36
const TUid KUidMsvEmailExternalBodyEntry	= {KUidMsvEmailExternalBodyEntryValue};
williamr@2
    37
const TUid KUidMsvEmailRtfEntry				= {KUidMsvEmailRtfEntryValue};
williamr@2
    38
williamr@2
    39
williamr@2
    40
_LIT8(KMiutDateFormat, " %S, %2d %S %04d %02d:%02d:%02d ");
williamr@2
    41
_LIT8(KMiutMonthNames, "JanFebMarAprMayJunJulAugSepOctNovDec");
williamr@2
    42
_LIT8(KMiutDayNames, "MonTueWedThuFriSatSun");
williamr@2
    43
_LIT8(KMiutTimeZoneNeg, "-%02d%02d");
williamr@2
    44
_LIT8(KMiutTimeZonePos, "+%02d%02d");
williamr@2
    45
williamr@2
    46
_LIT8(KMiutBase64String, "Base64");
williamr@2
    47
_LIT8(KMiutQPString, "quoted-printable");
williamr@2
    48
_LIT8(KMiut7BitString, "7bit");
williamr@2
    49
_LIT8(KMiut8BitString, "8bit");
williamr@2
    50
_LIT8(KMiutBinaryString, "binary");
williamr@2
    51
_LIT8(KMiutUUString, "uuencode");
williamr@2
    52
williamr@2
    53
_LIT8(KMiutWildcardBase64, "*base64*");
williamr@2
    54
_LIT8(KMiutWildcardQP, "*quoted-printable*");
williamr@2
    55
_LIT8(KMiutWildcard7Bit, "*7bit*");
williamr@2
    56
_LIT8(KMiutWildcard8Bit, "*8bit*");
williamr@2
    57
_LIT8(KMiutWildcardBinary, "*binary*");
williamr@2
    58
_LIT8(KMiutWildcardUU, "*uu*");
williamr@2
    59
williamr@2
    60
#define KMiutEmptyString KNullDesC
williamr@2
    61
williamr@2
    62
_LIT(KMiutFormatString, "%S");
williamr@2
    63
_LIT(KImEngineResourceFile, "\\resource\\messaging\\imcm.rsc");
williamr@2
    64
williamr@2
    65
const TInt KMiutDateStringLength	= 32;
williamr@2
    66
const TInt KCenturyThreshold		= 100;
williamr@2
    67
const TInt KCenturyOffset			= 70;
williamr@2
    68
const TInt KThisCentury				= 1900;	// as defined in 1998
williamr@2
    69
const TInt KNextCentury				= 2000;
williamr@2
    70
williamr@2
    71
class CMsvStore;
williamr@2
    72
class TMsvEntry;
williamr@2
    73
class RMsvReadStream;
williamr@2
    74
class RMsvWriteStream;
williamr@2
    75
class CImConvertHeader;
williamr@2
    76
class CImEncodedHeader;
williamr@2
    77
williamr@2
    78
void CopyArrayL(const CDesCArray& aSource, CDesCArray& aDestination);
williamr@2
    79
williamr@2
    80
// Maximum size for descriptors stored in HBufC members of CImHeader = 1000 chars
williamr@2
    81
const TInt KMaxImHeaderStringLength = 1000;
williamr@2
    82
const TInt KMaxImMimeFieldLength	= 1000;
williamr@2
    83
const TInt KImMailMaxBufferSize		= 1000;	// 1000 is defined by the SMTP spec as max space
williamr@2
    84
const TInt KSmtpMaxBufferExcludingCRLF = 979; // Line length limit is 1000 chars per line including CRLF (RFC2822, Section 2.1.1)
williamr@2
    85
                                              // 1000 chars including "Field name: "+"Field body"+CRLF (here "Resent-Message-ID: " is largest field)
williamr@2
    86
williamr@2
    87
williamr@2
    88
/** Defines how emails will be encoded when they are sent.
williamr@2
    89
williamr@2
    90
MIME standards are defined in RFC 2045, RFC 2046 and RFC 2047. 
williamr@2
    91
@publishedAll
williamr@2
    92
@released
williamr@2
    93
*/
williamr@2
    94
enum TMsgOutboxBodyEncoding
williamr@2
    95
	{
williamr@2
    96
	/** Emails are sent with the default encoding, which is as for EMsgOutboxMIME. */
williamr@2
    97
	EMsgOutboxDefault,
williamr@2
    98
	/** Emails are sent as plain text RFC822 messages. 
williamr@2
    99
	
williamr@2
   100
	Attachments are encoded using UUEncoding algorithm. This method would not 
williamr@2
   101
	normally be used unless the sender was sure that the receiving mail clients 
williamr@2
   102
	don't support MIME. */
williamr@2
   103
	EMsgOutboxNoAlgorithm,
williamr@2
   104
	/** Text is encoded using quoted-printable encoding, and all attachments are encoded 
williamr@2
   105
	using BASE64 encoding.
williamr@2
   106
	
williamr@2
   107
	This is the default setting for this option. */
williamr@2
   108
	EMsgOutboxMIME,
williamr@2
   109
	/** Text parts of the message are sent as MIME TEXT/HTML parts, and are encoded 
williamr@2
   110
	using UTF-8 encoding system. 
williamr@2
   111
	
williamr@2
   112
	All attachments are encoded using BASE64 encoding. Receiving mail clients 
williamr@2
   113
	that do no support MHTML mail will display the HTML message text to the user 
williamr@2
   114
	including all HTML tags, etc. */
williamr@2
   115
	EMsgOutboxMHTMLAsMIME,
williamr@2
   116
	/** Each text part of the message is sent as two alternative MIME parts.
williamr@2
   117
	
williamr@2
   118
	The first part is sent as plain text using quoted-printable encoding, the 
williamr@2
   119
	second part is sent as a TEXT/HTML part which is encoded using UTF-8 encoding 
williamr@2
   120
	system. All attachments are encoded using BASE64 encoding. This is the standard 
williamr@2
   121
	encoding method if the user wishes to send MHTML mail. */
williamr@2
   122
	EMsgOutboxMHTMLAlternativeAsMIME
williamr@2
   123
	};
williamr@2
   124
williamr@2
   125
/** Messaging encoding types. 
williamr@2
   126
@publishedAll
williamr@2
   127
@released
williamr@2
   128
*/
williamr@2
   129
enum TImEncodingType 
williamr@2
   130
	{
williamr@2
   131
	/** Unknown. */
williamr@2
   132
	EEncodingTypeUnknown,
williamr@2
   133
	/** None. */
williamr@2
   134
	EEncodingTypeNone,
williamr@2
   135
	/** 7-bit. */
williamr@2
   136
	EEncodingType7Bit,
williamr@2
   137
	/** 8-bit. */
williamr@2
   138
	EEncodingType8Bit,		// ie lines still <1000 chars and terminated by CRLF
williamr@2
   139
	/** Binary. */
williamr@2
   140
	EEncodingTypeBinary,	// ie any length of data, not terminated by CRLF
williamr@2
   141
	/** QP. */
williamr@2
   142
	EEncodingTypeQP,
williamr@2
   143
	/** Base64. */
williamr@2
   144
	EEncodingTypeBASE64,
williamr@2
   145
	/** UU. */
williamr@2
   146
	EEncodingTypeUU
williamr@2
   147
	};
williamr@2
   148
williamr@2
   149
williamr@2
   150
// Class used for storing extracting information (to/from header)..
williamr@2
   151
// regarding the encoding in an incoming email message header.
williamr@2
   152
//----------------------------------------------------------------------------------------
williamr@2
   153
class TImHeaderEncodingInfo
williamr@2
   154
//----------------------------------------------------------------------------------------
williamr@2
   155
/** Stores encoding data found in message headers. 
williamr@2
   156
@publishedAll
williamr@2
   157
@released
williamr@2
   158
*/
williamr@2
   159
	{
williamr@2
   160
public:
williamr@2
   161
	/** Message field types. */
williamr@2
   162
	enum TFieldList 
williamr@2
   163
		{ 
williamr@2
   164
		EFrom, 		/**< "From" field. */
williamr@2
   165
		EReplyTo, 	/**< "Reply To" field. */
williamr@2
   166
		ETo, 		/**< "To" field. */
williamr@2
   167
		ECc, 		/**< "Cc" field. */
williamr@2
   168
		EBcc, 		/**< "Bcc" field. */
williamr@2
   169
		ESubject	/**< Subject field. */
williamr@2
   170
		};
williamr@2
   171
	/** Encoding types. */
williamr@2
   172
	enum TEncodingType 
williamr@2
   173
		{ 
williamr@2
   174
		EBase64, 		/**< Base64. */
williamr@2
   175
		EQP, 			/**< QP. */
williamr@2
   176
		ENoEncoding, 	/**< No encoding */
williamr@2
   177
		EUU				/**< UU. */
williamr@2
   178
		};
williamr@2
   179
williamr@2
   180
public:
williamr@2
   181
	IMPORT_C TImHeaderEncodingInfo();
williamr@2
   182
	IMPORT_C TImHeaderEncodingInfo(const TImHeaderEncodingInfo& aFrom);
williamr@2
   183
williamr@2
   184
	IMPORT_C void ExternalizeL( RWriteStream& aWriteStream ) const;
williamr@2
   185
	IMPORT_C void InternalizeL( RReadStream& aReadStream );
williamr@2
   186
williamr@2
   187
	inline void SetField(const TFieldList aField);
williamr@2
   188
	inline TFieldList Field() const;
williamr@2
   189
williamr@2
   190
	inline void SetOffset(const TInt aOffset);
williamr@2
   191
	inline TInt Offset() const;
williamr@2
   192
williamr@2
   193
	inline void SetLength(const TInt aLength);
williamr@2
   194
	inline TInt Length() const;
williamr@2
   195
williamr@2
   196
	inline void SetCharsetUid(const TUint aUid);
williamr@2
   197
	inline TUint CharsetUid() const;
williamr@2
   198
williamr@2
   199
	inline void SetEncodingType(const TDesC8& aChar);
williamr@2
   200
	inline void SetEncodingType(const TEncodingType aType);
williamr@2
   201
	inline  TEncodingType EncodingType() const;
williamr@2
   202
williamr@2
   203
	inline void SetArrayValue(const TInt aValue);
williamr@2
   204
	inline  TInt ArrayValue() const;
williamr@2
   205
williamr@2
   206
	inline void SetAddSpace(const TBool atrueFalse);
williamr@2
   207
	inline  TBool AddSpace() const;
williamr@2
   208
williamr@2
   209
	inline void SetEncodedLength(const TInt aLength);
williamr@2
   210
	inline TInt EncodedLength() const;
williamr@2
   211
williamr@2
   212
private:
williamr@2
   213
	TFieldList		iField; 
williamr@2
   214
	TUint16			iOffset;
williamr@2
   215
	TUint16			iLength;
williamr@2
   216
	TEncodingType	iType;
williamr@2
   217
	TUint16			iArrayValue;
williamr@2
   218
	TBool	iAddSpace; // A space char needs adding between two adjoining 'encoded-words'
williamr@2
   219
	TUint8	iEncodedLength; // This can be used to determine space needed for buffer.
williamr@2
   220
	TUint	iCharsetUid; 
williamr@2
   221
williamr@2
   222
	};
williamr@2
   223
williamr@2
   224
williamr@2
   225
//------------------------------------------------------------------------------
williamr@2
   226
williamr@2
   227
williamr@2
   228
class CImHeader : public CBase
williamr@2
   229
/** Encapsulates an Internet Mail (RFC822) header.
williamr@2
   230
williamr@2
   231
Note that the class contains some obsolete functions that take a narrow descriptor: 
williamr@2
   232
always use the equivalent wide descriptor function instead. 
williamr@2
   233
@publishedAll
williamr@2
   234
@released
williamr@2
   235
*/
williamr@2
   236
	{
williamr@2
   237
public:
williamr@2
   238
/** Flags used to determine where to obtain the ReplyTo address for the header 
williamr@2
   239
field of that name. */
williamr@2
   240
	enum TReplyTo 
williamr@2
   241
		{ 
williamr@2
   242
	/** Get address from originator. */
williamr@2
   243
		EOriginator, 
williamr@2
   244
	/** Get address from sender. */
williamr@2
   245
		ESender, 
williamr@2
   246
	/** Get address from all sources. */
williamr@2
   247
		EAll,
williamr@2
   248
	/** Get address from recipients. */
williamr@2
   249
		ERecipients
williamr@2
   250
		};
williamr@2
   251
williamr@2
   252
	IMPORT_C static CImHeader* NewLC();
williamr@2
   253
	IMPORT_C ~CImHeader();
williamr@2
   254
	IMPORT_C void Reset();
williamr@2
   255
williamr@2
   256
	// streaming operations
williamr@2
   257
	IMPORT_C void InternalizeL(RMsvReadStream& aReadStream);
williamr@2
   258
	IMPORT_C void ExternalizeL(RMsvWriteStream& aWriteStream) const;
williamr@2
   259
	IMPORT_C void RestoreL(CMsvStore& aMessageStore);
williamr@2
   260
	IMPORT_C void StoreL  (CMsvStore& aMessageStore) const;
williamr@2
   261
	IMPORT_C void StoreWithoutCommitL(CMsvStore& aMessageStore) const;
williamr@2
   262
williamr@2
   263
	// the bulk of the member functions are accessors & mutators so we can use
williamr@2
   264
	// objects of the class as data repositories during the data-marshalling stage
williamr@2
   265
	// of getting imail headers to/from the internet
williamr@2
   266
	IMPORT_C const TPtrC Subject() const;
williamr@2
   267
	IMPORT_C void SetSubjectL(const TDesC8& aSubject);
williamr@2
   268
williamr@2
   269
	// Internet message ID
williamr@2
   270
	IMPORT_C const TPtrC8 ImMsgId() const;
williamr@2
   271
	/** Sets the "MessageId" header field.
williamr@2
   272
	
williamr@2
   273
	@param aImMsgIdL Field value */
williamr@2
   274
	IMPORT_C void SetImMsgIdL(const TDesC8& aImMsgIdL);
williamr@2
   275
williamr@2
   276
	IMPORT_C const TPtrC From() const;
williamr@2
   277
	IMPORT_C void SetFromL(const TDesC8& aFrom);
williamr@2
   278
williamr@2
   279
	IMPORT_C const TPtrC ReplyTo() const;
williamr@2
   280
	IMPORT_C void SetReplyToL(const TDesC8& aReplyTo);
williamr@2
   281
williamr@2
   282
	IMPORT_C const TPtrC ReceiptAddress() const;
williamr@2
   283
	/** Sets the "Receipt" header field. 
williamr@2
   284
	
williamr@2
   285
	@param aReceiptAddress Field value */
williamr@2
   286
	IMPORT_C void SetReceiptAddressL(const TDesC8& aReceiptAddress);
williamr@2
   287
williamr@2
   288
	IMPORT_C TUint Charset() const;
williamr@2
   289
	IMPORT_C void SetCharset(const TUint aCharset);
williamr@2
   290
williamr@2
   291
#if defined (_UNICODE)
williamr@2
   292
	IMPORT_C void SetFromL(const TDesC16& aFrom);
williamr@2
   293
	IMPORT_C void SetReplyToL(const TDesC16& aReplyTo);
williamr@2
   294
	/** Sets the "Receipt" header field. 
williamr@2
   295
	
williamr@2
   296
	@param aReceiptAddress Field value */
williamr@2
   297
	IMPORT_C void SetReceiptAddressL(const TDesC16& aReceiptAddress);
williamr@2
   298
	IMPORT_C void SetSubjectL(const TDesC16& aSubject);
williamr@2
   299
#endif
williamr@2
   300
williamr@2
   301
	IMPORT_C TInt DataSize();
williamr@2
   302
williamr@2
   303
	inline const TUint RemoteSize() const;
williamr@2
   304
	inline void SetRemoteSize(TUint aSize);
williamr@2
   305
williamr@2
   306
	inline const TUint16 Version() const;
williamr@2
   307
	inline void SetVersion(TUint16 aVersion);
williamr@2
   308
williamr@2
   309
	// give const access to the recipient lists
williamr@2
   310
	inline const CDesCArray& ToRecipients () const;
williamr@2
   311
	inline const CDesCArray& CcRecipients () const;
williamr@2
   312
	inline const CDesCArray& BccRecipients() const;
williamr@2
   313
	
williamr@2
   314
	// give non-const access to the recipient lists
williamr@2
   315
	inline CDesCArray& ToRecipients () ;
williamr@2
   316
	inline CDesCArray& CcRecipients () ;
williamr@2
   317
	inline CDesCArray& BccRecipients() ;
williamr@2
   318
williamr@2
   319
	inline CArrayFix<TImHeaderEncodingInfo>& EncodingInfo() ;
williamr@2
   320
	inline const CArrayFix<TImHeaderEncodingInfo>& EncodingInfo() const;
williamr@2
   321
williamr@2
   322
	IMPORT_C void AddEncodingInfoL(TImHeaderEncodingInfo& aInfo);
williamr@2
   323
williamr@2
   324
//-------------------------------------------------------------------------------------
williamr@2
   325
//----------------------Used for forwarding/replying to an email ----------------------
williamr@2
   326
williamr@2
   327
	IMPORT_C const TPtrC8 ResentMsgId() const;
williamr@2
   328
	IMPORT_C void SetResentMsgIdL( const TDesC8& );
williamr@2
   329
williamr@2
   330
	IMPORT_C const TPtrC ResentFrom() const;
williamr@2
   331
	IMPORT_C void SetResentFromL( const TDesC& );
williamr@2
   332
williamr@2
   333
	// give const access to the recipient lists
williamr@2
   334
	inline const CDesCArray& ResentToRecipients () const;
williamr@2
   335
	inline const CDesCArray& ResentCcRecipients () const;
williamr@2
   336
	inline const CDesCArray& ResentBccRecipients() const;
williamr@2
   337
williamr@2
   338
	// give non-const access to the recipient lists
williamr@2
   339
	inline CDesCArray& ResentToRecipients ();
williamr@2
   340
	inline CDesCArray& ResentCcRecipients ();
williamr@2
   341
	inline CDesCArray& ResentBccRecipients();
williamr@2
   342
williamr@2
   343
	IMPORT_C const TPtrC8 InReplyTo() const;
williamr@2
   344
	IMPORT_C void SetInReplyToL(const TDesC8&);
williamr@2
   345
williamr@2
   346
	IMPORT_C TInt CreateForwardL(CImHeader&, TDesC&);
williamr@2
   347
	IMPORT_C TInt CreateReplyL(CImHeader&, TReplyTo, TDesC&);
williamr@2
   348
	IMPORT_C void CreateReceiptL(CImHeader&, TDesC&);
williamr@2
   349
williamr@2
   350
//-------------------------------------------------------------------------------------
williamr@2
   351
//-------------------------------------------------------------------------------------
williamr@2
   352
williamr@2
   353
	// Body Encoding (charset) stored on a per message basis
williamr@2
   354
	IMPORT_C TMsgOutboxBodyEncoding BodyEncoding() const;
williamr@2
   355
	IMPORT_C void SetBodyEncoding(TMsgOutboxBodyEncoding aMessageBodyEncoding);
williamr@2
   356
williamr@2
   357
	IMPORT_C void ReDecodeL(RFs& aFS);
williamr@2
   358
	IMPORT_C TUint OverrideCharset() const;
williamr@2
   359
	IMPORT_C void SetOverrideCharset(TUint aCharset);
williamr@2
   360
	IMPORT_C void SaveEncodedHeadersL();
williamr@2
   361
williamr@2
   362
private:
williamr@2
   363
	CImHeader();
williamr@2
   364
	void ConstructL();
williamr@2
   365
	
williamr@2
   366
	// these four functions keep the line count down as there are several instances
williamr@2
   367
	// of streaming in/out HBufC objects.
williamr@2
   368
	void ReadRecipientsL ( RReadStream&, CDesCArray* );
williamr@2
   369
	void WriteRecipientsL( RWriteStream&, const CDesCArray* ) const;
williamr@2
   370
	void FormatSubjectL(CImHeader&, TDesC&);
williamr@2
   371
williamr@2
   372
	//finds the duplicate recipients in To and Cc list
williamr@2
   373
	TBool IsRecipientPresent(CImHeader& aCImHeader, TPtrC16 newRecipient);
williamr@2
   374
williamr@2
   375
private:
williamr@2
   376
	TUint16 iVersion;
williamr@2
   377
williamr@2
   378
	HBufC16* iFrom;
williamr@2
   379
	HBufC* iSubject;
williamr@2
   380
	HBufC8* iImMsgId;
williamr@2
   381
	HBufC16* iReplyTo;
williamr@2
   382
	HBufC16* iReceipt;
williamr@2
   383
williamr@2
   384
	CDesCArray* iTo;
williamr@2
   385
	CDesCArray* iCc;
williamr@2
   386
	CDesCArray* iBcc;
williamr@2
   387
	TUint iRemoteSize;
williamr@2
   388
williamr@2
   389
//-------------------------------------------------------------------------------------
williamr@2
   390
//----------------------Used for forwarding/replying to an email ----------------------
williamr@2
   391
williamr@2
   392
	HBufC* iResentFrom;
williamr@2
   393
	HBufC8* iResentMsgId;
williamr@2
   394
 	CDesCArray* iResentTo;
williamr@2
   395
	CDesCArray* iResentCc;
williamr@2
   396
	CDesCArray* iResentBcc;
williamr@2
   397
	HBufC8* iInReplyTo;
williamr@2
   398
williamr@2
   399
//-------------------------------------------------------------------------------------
williamr@2
   400
//-------------------------------------------------------------------------------------
williamr@2
   401
	CArrayFix<TImHeaderEncodingInfo>* iEncodingInfo;
williamr@2
   402
	TMsgOutboxBodyEncoding			iBodyEncoding;
williamr@2
   403
	// The character set to be when sending message.
williamr@2
   404
	// Overrides the charset passed in from the settings.
williamr@2
   405
	TUint							i822HeaderCharset; 
williamr@2
   406
williamr@2
   407
	CImEncodedHeader* iEncodedHeader;
williamr@2
   408
	};
williamr@2
   409
williamr@2
   410
class TImRfc822DateField
williamr@2
   411
/**
williamr@2
   412
@internalTechnology
williamr@2
   413
@released
williamr@2
   414
*/
williamr@2
   415
	{
williamr@2
   416
public:
williamr@2
   417
	IMPORT_C TInt ParseDateField(const TDesC8& aRfc822DateField, TTime& rTime);
williamr@2
   418
	IMPORT_C void SetDate(const TTime& aTimeDate, TDes8& rOutputLine);	// NB assumes that "Date: " string has already been inserted into  rOutputLine
williamr@2
   419
williamr@2
   420
private:
williamr@2
   421
	TBool GetMonth( const TDesC8& name, TMonth& month );
williamr@2
   422
	TBool GetTimezone( const TDesC8& name, TInt& minsOffset );
williamr@2
   423
	};
williamr@2
   424
williamr@2
   425
williamr@2
   426
/** Folder type flags.
williamr@2
   427
williamr@2
   428
The flags correspond to the MIME multipart subtype. 
williamr@2
   429
@publishedAll
williamr@2
   430
@released
williamr@2
   431
*/
williamr@2
   432
enum TImEmailFolderType
williamr@2
   433
	{
williamr@2
   434
	/** Unknown. */
williamr@2
   435
	EFolderTypeUnknown,
williamr@2
   436
	/** Related. */
williamr@2
   437
	EFolderTypeRelated,
williamr@2
   438
	/** Mixed. */
williamr@2
   439
	EFolderTypeMixed,
williamr@2
   440
	/** Parallel. */
williamr@2
   441
	EFolderTypeParallel,
williamr@2
   442
	/** Alternative. */
williamr@2
   443
	EFolderTypeAlternative,
williamr@2
   444
	/** Digest. */
williamr@2
   445
	EFolderTypeDigest,
williamr@2
   446
	/** RFC822. */
williamr@2
   447
	EFolderTypeRFC822,
williamr@2
   448
	/** Partial. */
williamr@2
   449
	EFolderTypePartial,
williamr@2
   450
	/** Directory. */
williamr@2
   451
	EFolderTypeDirectory,
williamr@2
   452
	/** External. */
williamr@2
   453
	EFolderTypeExternal
williamr@2
   454
	};
williamr@2
   455
williamr@2
   456
/** Describes the types of off-line email operations than can occur.
williamr@2
   457
williamr@2
   458
@see TMsvEmailEntry::DisconnectedOperation() 
williamr@2
   459
@publishedAll
williamr@2
   460
@released
williamr@2
   461
*/
williamr@2
   462
enum TImDisconnectedOperationType
williamr@2
   463
	{
williamr@2
   464
	/** No operation. */
williamr@2
   465
	ENoDisconnectedOperations,
williamr@2
   466
	/** Create operation. */
williamr@2
   467
	EDisconnectedCreateOperation,
williamr@2
   468
	/** Delete operation. */
williamr@2
   469
	EDisconnectedDeleteOperation,
williamr@2
   470
	/** Change operation. */
williamr@2
   471
	EDisconnectedChangeOperation,
williamr@2
   472
	/** "Copy to" operation. */
williamr@2
   473
	EDisconnectedCopyToOperation,
williamr@2
   474
	/** "Copy from" operation. */
williamr@2
   475
	EDisconnectedCopyFromOperation,
williamr@2
   476
	/** "Copy within service" operation. */
williamr@2
   477
	EDisconnectedCopyWithinServiceOperation,
williamr@2
   478
	/** "Move to" operation. */
williamr@2
   479
	EDisconnectedMoveToOperation,
williamr@2
   480
	/** "Move from" operation. */
williamr@2
   481
	EDisconnectedMoveFromOperation,
williamr@2
   482
	/** "Move within service" operation. */
williamr@2
   483
	EDisconnectedMoveWithinServiceOperation,
williamr@2
   484
	/** Special operation. */
williamr@2
   485
	EDisconnectedSpecialOperation,
williamr@2
   486
	/** Unknown operation. */
williamr@2
   487
	EDisconnectedUnknownOperation,
williamr@2
   488
	/** Multiple operations. */
williamr@2
   489
	EDisconnectedMultipleOperation
williamr@2
   490
	};
williamr@2
   491
williamr@2
   492
// Remote folder message count limited to TUint16 by using lower 16 bits of "iMtmData3".
williamr@2
   493
// Note: The upper 16 bits of "iMtmData3" are not currently used by "TMsvEmailEntry".
williamr@2
   494
const TUint KMsvRemoteFolderEntriesMask =		0x0000FFFF;
williamr@2
   495
williamr@2
   496
class TMsvEmailEntry : public TMsvEntry
williamr@2
   497
/** Provides storage for and access to extra email specific information for a message.
williamr@2
   498
williamr@2
   499
To get a TMsvEmailEntry, get the entry's TMsvEntry, e.g. using
williamr@2
   500
@c CMsvEntry::Entry(), and use the constructor that takes a TMsvEntry parameter.
williamr@2
   501
williamr@2
   502
Many of the flags are only used by IMAP4 entries. These can be grouped as follows:
williamr@2
   503
williamr@2
   504
- IMAP-specific flags, as defined by the IMAP protocol (see RFC3501, 2.3.2. Flags Message Attribute)
williamr@2
   505
  - GetIMAP4Flags() and SetIMAP4Flags() handle all the flags as a group
williamr@2
   506
  - \\Seen flag: SetSeenIMAP4Flag(), SeenIMAP4Flag(). 
williamr@2
   507
  - \\Answered flag: SetAnsweredIMAP4Flag(), AnsweredIMAP4Flag()
williamr@2
   508
  - \\Flagged flag: SetFlaggedIMAP4Flag(), FlaggedIMAP4Flag()
williamr@2
   509
  - \\Deleted flag: SetDeletedIMAP4Flag(), DeletedIMAP4Flag() 
williamr@2
   510
  - \\Draft flag: SetDraftIMAP4Flag(), DraftIMAP4Flag() 
williamr@2
   511
  - \\Recent flag: SetRecentIMAP4Flag(), RecentIMAP4Flag()
williamr@2
   512
- Folder subscriptions and other folder-related flags: 
williamr@2
   513
  - SetMailbox(), Mailbox(), 
williamr@2
   514
  - SetSubscribed(), Subscribed(), 
williamr@2
   515
  - SetLocalSubscription(), LocalSubscription()
williamr@2
   516
  - SetRemoteFolderEntries(), RemoteFolderEntries()  
williamr@2
   517
- Disconnected operation information:
williamr@2
   518
  - SetDisconnectedOperation(), DisconnectedOperation().
williamr@2
   519
- Partial download flags: these flags allow a client to test if a message or its body has
williamr@2
   520
  been partially downloaded (see TImImap4GetPartialMailInfo)   
williamr@2
   521
  - SetPartialDownloaded(), PartialDownloaded() 
williamr@2
   522
  - SetBodyTextComplete(), BodyTextComplete()
williamr@2
   523
- UID information: IMAP messages have a unique identifier number (see 
williamr@2
   524
  RFC3501, 2.3.1.1. Unique Identifier (UID) Message Attribute)
williamr@2
   525
  - SetValidUID(), ValidUID()
williamr@2
   526
  - SetUID(), UID().
williamr@2
   527
  
williamr@2
   528
The following flags are set only by the IMAP MTM. They indicate if the 
williamr@2
   529
message contains a vCard, vCalendar (http://www.imc.org), or iCalendar (RFC 2445) attachment.
williamr@2
   530
williamr@2
   531
- VCard(), SetVCard()
williamr@2
   532
- VCalendar(), SetVCalendar() 
williamr@2
   533
- ICalendar(), SetICalendar()
williamr@2
   534
williamr@2
   535
The following flags apply to all email protocols:
williamr@2
   536
williamr@2
   537
- Receipt requested: Receipt(), SetReceipt()
williamr@2
   538
- MHTML content: MHTMLEmail(), SetMHTMLEmail()
williamr@2
   539
williamr@2
   540
Note that the email specific data is stored in the reserved data members @c iMtmData1, 
williamr@2
   541
@c iMtmData2 and @c iMtmData3 of the TMsvEntry base class. These public data members 
williamr@2
   542
must not be directly altered by clients.
williamr@2
   543
williamr@2
   544
@publishedAll
williamr@2
   545
@released
williamr@2
   546
@see CImap4ClientMtm
williamr@2
   547
*/
williamr@2
   548
	{
williamr@2
   549
public: // Public member functions
williamr@2
   550
	IMPORT_C TMsvEmailEntry();	// default constructor
williamr@2
   551
	IMPORT_C TMsvEmailEntry(const TMsvEntry& aGenericEntry); 
williamr@2
   552
williamr@2
   553
	IMPORT_C TBool operator==(const TMsvEntry& aEntry) const;
williamr@2
   554
	IMPORT_C TBool operator==(const TMsvEmailEntry& aEntry) const;
williamr@2
   555
williamr@2
   556
	IMPORT_C void GetIMAP4Flags(TBool& rUnread,TBool& rSeen,TBool& rAnswered,TBool& rFlagged,TBool& rDeleted,TBool& rDraft,TBool& rRecent);
williamr@2
   557
	IMPORT_C void SetIMAP4Flags(TBool aUnread,TBool aSeen,TBool aAnswered,TBool aFlagged,TBool aDeleted,TBool aDraft,TBool aRecent);
williamr@2
   558
williamr@2
   559
	IMPORT_C void SetMessageFolderType(TImEmailFolderType aFolderType);
williamr@2
   560
	IMPORT_C TImEmailFolderType MessageFolderType() const;
williamr@2
   561
williamr@2
   562
	IMPORT_C void SetDisconnectedOperation(TImDisconnectedOperationType aDisconnectedOperationType);
williamr@2
   563
	IMPORT_C TImDisconnectedOperationType DisconnectedOperation() const;
williamr@2
   564
williamr@2
   565
	IMPORT_C void SetPartialDownloaded(TBool aPartialDownloaded);
williamr@2
   566
	IMPORT_C TBool PartialDownloaded() const;
williamr@2
   567
williamr@2
   568
	//
williamr@2
   569
	inline void SetEncrypted(TBool aEncrypt);
williamr@2
   570
	inline TBool Encrypted() const;
williamr@2
   571
	//
williamr@2
   572
	inline void SetSigned(TBool aSignature);
williamr@2
   573
	inline TBool Signed() const;
williamr@2
   574
	//
williamr@2
   575
	inline TBool VCard() const;
williamr@2
   576
	inline void SetVCard(TBool aVCard);
williamr@2
   577
	//
williamr@2
   578
	inline TBool VCalendar() const;
williamr@2
   579
	inline void SetVCalendar(TBool aVCal);
williamr@2
   580
	//
williamr@2
   581
	inline TBool ICalendar() const;
williamr@2
   582
	inline void SetICalendar(TBool aICal);
williamr@2
   583
	//
williamr@2
   584
	inline TBool Receipt() const;
williamr@2
   585
	inline void SetReceipt(TBool aReceipt);
williamr@2
   586
williamr@2
   587
	inline TBool MHTMLEmail() const;
williamr@2
   588
	inline void SetMHTMLEmail(TBool aMhtml);
williamr@2
   589
williamr@2
   590
	inline TBool BodyTextComplete() const;
williamr@2
   591
	inline void SetBodyTextComplete(TBool aFlag);
williamr@2
   592
williamr@2
   593
	//
williamr@2
   594
	// IMAP4-specific flags
williamr@2
   595
	//
williamr@2
   596
	inline void SetUnreadIMAP4Flag(TBool aUnread);
williamr@2
   597
	inline TBool UnreadIMAP4Flag() const;
williamr@2
   598
	//
williamr@2
   599
	inline void SetSeenIMAP4Flag(TBool aSeen);
williamr@2
   600
	inline TBool SeenIMAP4Flag() const;
williamr@2
   601
	//
williamr@2
   602
	inline void SetAnsweredIMAP4Flag(TBool aAnswered);
williamr@2
   603
	inline TBool AnsweredIMAP4Flag() const;
williamr@2
   604
	//
williamr@2
   605
	inline void SetFlaggedIMAP4Flag(TBool aFlagged);
williamr@2
   606
	inline TBool FlaggedIMAP4Flag() const;
williamr@2
   607
	//
williamr@2
   608
	inline void SetDeletedIMAP4Flag(TBool aDeleted);
williamr@2
   609
	inline TBool DeletedIMAP4Flag() const;
williamr@2
   610
	//
williamr@2
   611
	inline void SetDraftIMAP4Flag(TBool aDraft);
williamr@2
   612
	inline TBool DraftIMAP4Flag() const;
williamr@2
   613
	//
williamr@2
   614
	inline void SetRecentIMAP4Flag(TBool aRecent);
williamr@2
   615
	inline TBool RecentIMAP4Flag() const;
williamr@2
   616
	//
williamr@2
   617
	inline void SetMailbox(TBool aMailbox);
williamr@2
   618
	inline TBool Mailbox() const;
williamr@2
   619
	//
williamr@2
   620
	inline TBool Orphan() const;
williamr@2
   621
williamr@2
   622
	inline void SetOrphan(TBool aOrphan);
williamr@2
   623
	//
williamr@2
   624
	inline void SetValidUID(TBool aValid);
williamr@2
   625
	inline TBool ValidUID() const;
williamr@2
   626
	//
williamr@2
   627
	inline void SetSubscribed(TBool aSubscribed);
williamr@2
   628
	inline TBool Subscribed() const;
williamr@2
   629
	//
williamr@2
   630
	inline void SetLocalSubscription(TBool aLocal);		// i.e. is subscription local, or remote
williamr@2
   631
	inline TBool LocalSubscription() const;
williamr@2
   632
	//
williamr@2
   633
	inline void SetUID(TUint32 aUid);
williamr@2
   634
	inline TUint32 UID() const;
williamr@2
   635
	//
williamr@2
   636
	inline TInt RemoteFolderEntries() const;
williamr@2
   637
	inline void SetRemoteFolderEntries(TInt aEntries);
williamr@2
   638
williamr@2
   639
private:
williamr@2
   640
	enum TMsvEmailEntryFlags
williamr@2
   641
		{	
williamr@2
   642
		KMsvEmailEntryClearFlag				=0x00,
williamr@2
   643
		// Flags set on Message entries...
williamr@2
   644
		KMsvEmailEntryEncryptedFlag			=0x00000001,
williamr@2
   645
		KMsvEmailEntrySignedFlag			=0x00000002,
williamr@2
   646
		KMsvEmailEntryReceiptFlag			=0x00000004,
williamr@2
   647
		KMsvEmailEntryOrphanFlag			=0x00000008,
williamr@2
   648
williamr@2
   649
		// VCard and VCalendar entries may be set on folders or attachments
williamr@2
   650
		KMsvEmailEntryVCardFlag				=0x00000010,
williamr@2
   651
		KMsvEmailEntryVCalendarFlag			=0x00000020,
williamr@2
   652
williamr@2
   653
		// Message contains HTML data
williamr@2
   654
		// (Note: HTML and not only MHTML)
williamr@2
   655
		KMsvEmailEntryMHTMLFlag				= 0x00000040,
williamr@2
   656
		KMsvEmailEntryBodyTextCompleteFlag	= 0x00000080,
williamr@2
   657
williamr@2
   658
		KMsvEmailEntryNoDisconnectedOperations					= 0x00000000,
williamr@2
   659
		KMsvEmailEntryDisconnectedCreateOperation				= 0x00000100,
williamr@2
   660
		KMsvEmailEntryDisconnectedDeleteOperation				= 0x00000200,
williamr@2
   661
		KMsvEmailEntryDisconnectedChangeOperation				= 0x00000300,
williamr@2
   662
		KMsvEmailEntryDisconnectedCopyToOperation				= 0x00000400,
williamr@2
   663
		KMsvEmailEntryDisconnectedCopyFromOperation				= 0x00000500,
williamr@2
   664
		KMsvEmailEntryDisconnectedCopyWithinServiceOperation	= 0x00000600,
williamr@2
   665
		KMsvEmailEntryDisconnectedMoveToOperation				= 0x00000700,
williamr@2
   666
		KMsvEmailEntryDisconnectedMoveFromOperation				= 0x00000800,
williamr@2
   667
		KMsvEmailEntryDisconnectedMoveWithinServiceOperation	= 0x00000900,
williamr@2
   668
		KMsvEmailEntryDisconnectedSpecialOperation				= 0x00000A00,
williamr@2
   669
		KMsvEmailEntryDisconnectedUnknownOperation				= 0x00000B00,
williamr@2
   670
		KMsvEmailEntryDisconnectedMultipleOperation				= 0x00000C00,
williamr@2
   671
		KMsvEmailEntryDisconnectedOperation						= 0x00000F00,
williamr@2
   672
williamr@2
   673
		// IMAP4-specific masks. Can be re-used by non-IMAP4 entries (eg POP3, SMTP)
williamr@2
   674
		KMsvEmailEntryIMAP4SubscribedFlag	=0x00001000,
williamr@2
   675
		KMsvEmailEntryIMAP4UnreadFlag		=0x00002000,
williamr@2
   676
		KMsvEmailEntryIMAP4SeenFlag			=0x00004000,
williamr@2
   677
		KMsvEmailEntryIMAP4AnsweredFlag		=0x00008000,	
williamr@2
   678
		KMsvEmailEntryIMAP4FlaggedFlag		=0x00010000,	
williamr@2
   679
		KMsvEmailEntryIMAP4DeletedFlag		=0x00020000,	
williamr@2
   680
		KMsvEmailEntryIMAP4DraftFlag		=0x00040000,	
williamr@2
   681
		KMsvEmailEntryIMAP4RecentFlag		=0x00080000,	
williamr@2
   682
		KMsvEmailEntryIMAP4ValidUIDFlag		=0x00100000,
williamr@2
   683
		KMsvEmailEntryIMAP4MailboxFlag		=0x00200000,
williamr@2
   684
		KMsvEmailEntryIMAP4LocalSubFlag		=0x00400000,
williamr@2
   685
williamr@2
   686
		// MIME "multipart" types assigned to folders. 
williamr@2
   687
		KMsvMimeFolderUnknownMask			=0x00000000,
williamr@2
   688
		KMsvMimeFolderRelatedMask			=0x01000000,
williamr@2
   689
		KMsvMimeFolderMixedMask				=0x02000000,
williamr@2
   690
		KMsvMimeFolderAlternativeMask		=0x03000000,
williamr@2
   691
		KMsvMimeFolderParallelMask			=0x04000000,
williamr@2
   692
		KMsvMimeFolderDigestMask			=0x05000000,
williamr@2
   693
williamr@2
   694
		// MIME message types
williamr@2
   695
		KMsvMimeFolderRFC822Mask			=0x06000000,
williamr@2
   696
		KMsvMimeFolderPartialMask			=0x07000000,
williamr@2
   697
		KMsvMimeFolderDirectoryMask			=0x08000000,	// for VCard, VCalendar types
williamr@2
   698
		KMsvMimeFolderExternalMask			=0x09000000,
williamr@2
   699
		KMsvMimeFolderMask					=0x0F000000,
williamr@2
   700
		
williamr@2
   701
		// Can be used by POP3 and IMAP4 MTMs.
williamr@2
   702
		KMsvEmailEntryPartialDownloadFlag	=0x10000000,
williamr@2
   703
		
williamr@2
   704
		KMsvEmailEntryICalendarFlag			=0x20000000
williamr@2
   705
		};
williamr@2
   706
williamr@2
   707
	};
williamr@2
   708
williamr@2
   709
const TUint16 KImMimeHeaderVersion = 2; // identify which version of this class has been stored
williamr@2
   710
williamr@2
   711
class CImMimeHeader : public CBase
williamr@2
   712
/** Stores a MIME email header. 
williamr@2
   713
@publishedAll
williamr@2
   714
@released
williamr@2
   715
*/
williamr@2
   716
	{
williamr@2
   717
public:
williamr@2
   718
	IMPORT_C static CImMimeHeader* NewLC();
williamr@2
   719
	IMPORT_C static CImMimeHeader* NewL();
williamr@2
   720
	IMPORT_C ~CImMimeHeader();
williamr@2
   721
	IMPORT_C void Reset();
williamr@2
   722
	IMPORT_C TInt Size();	// number of header fields stored in object
williamr@2
   723
williamr@2
   724
	// streaming operations
williamr@2
   725
	IMPORT_C void InternalizeL( RMsvReadStream& aReadStream );
williamr@2
   726
	IMPORT_C void ExternalizeL( RMsvWriteStream& aWriteStream ) const;
williamr@2
   727
	IMPORT_C void RestoreL( CMsvStore& aMessageStore );
williamr@2
   728
	IMPORT_C void StoreL  ( CMsvStore& aMessageStore ) const;
williamr@2
   729
	IMPORT_C void StoreWithoutCommitL(CMsvStore& aMessageStore) const;
williamr@2
   730
williamr@2
   731
	/** Sets the Content-Type field value (e.g. "text" in Content-Type:text/plain). 
williamr@2
   732
	
williamr@2
   733
	The value is MIME defined and should always be 8-bit. 
williamr@2
   734
	
williamr@2
   735
	@param aPath Field value */
williamr@2
   736
	IMPORT_C void SetContentTypeL(const TDesC8& aPath);
williamr@2
   737
	IMPORT_C const TPtrC8 ContentType() const;
williamr@2
   738
williamr@2
   739
	/** Sets the Content-Type subtype field value (e.g. "plain" in Content-Type:text/plain). 
williamr@2
   740
	
williamr@2
   741
	
williamr@2
   742
	The value is MIME defined and should always be 8-bit. 
williamr@2
   743
	
williamr@2
   744
	@param aPath Field value */
williamr@2
   745
	IMPORT_C void SetContentSubTypeL(const TDesC8& aPath);
williamr@2
   746
	IMPORT_C const TPtrC8 ContentSubType() const;
williamr@2
   747
williamr@2
   748
	/** Sets the Content-Disposition field value (either inline or attachment). 
williamr@2
   749
	
williamr@2
   750
	The value is MIME defined and should always be 8-bit. 
williamr@2
   751
	
williamr@2
   752
	@param aPath Field value */
williamr@2
   753
	IMPORT_C void SetContentDispositionL(const TDesC8& aPath);
williamr@2
   754
	IMPORT_C const TPtrC8 ContentDisposition() const;
williamr@2
   755
williamr@2
   756
	/** Sets the Content-Description field value.
williamr@2
   757
	
williamr@2
   758
	The value is MIME defined and should always be 8-bit. 
williamr@2
   759
	
williamr@2
   760
	@param aPath Field value */
williamr@2
   761
	IMPORT_C void SetContentDescriptionL(const TDesC8& aPath);
williamr@2
   762
	IMPORT_C const TPtrC8 ContentDescription() const;
williamr@2
   763
williamr@2
   764
	/** Sets the Content-Base field value.
williamr@2
   765
	
williamr@2
   766
	@param aPath Field value */
williamr@2
   767
	IMPORT_C void SetContentBaseL(const TDesC8& aPath);
williamr@2
   768
	IMPORT_C const TPtrC8 ContentBase() const;
williamr@2
   769
williamr@2
   770
	/** Sets the Content-ID field value.
williamr@2
   771
	
williamr@2
   772
	@param aPath Field value */
williamr@2
   773
	IMPORT_C void SetContentIDL(const TDesC8& aPath);
williamr@2
   774
	IMPORT_C const TPtrC8 ContentID() const;
williamr@2
   775
williamr@2
   776
	/** Sets the Content-Location field value.
williamr@2
   777
	
williamr@2
   778
	@param aPath Field value */
williamr@2
   779
	IMPORT_C void SetContentLocationL(const TDesC16& aPath);
williamr@2
   780
	IMPORT_C const TPtrC16 ContentLocation() const;
williamr@2
   781
williamr@2
   782
	// IMAP-specific info describing relative location of entry w.r.t. parent Email message
williamr@2
   783
	/** Sets IMAP-specific information for the relative location of the entry to the 
williamr@2
   784
	parent email message.
williamr@2
   785
	
williamr@2
   786
	@param aPath Relative location */
williamr@2
   787
	IMPORT_C void SetRelativePathL(const TDesC8& aPath);
williamr@2
   788
	IMPORT_C const TPtrC8 RelativePath() const;
williamr@2
   789
williamr@2
   790
	/** Sets the Content-Transfer-Encoding field value.
williamr@2
   791
	
williamr@2
   792
	@param aType Field value */
williamr@2
   793
	IMPORT_C void SetContentTransferEncodingL(const TDesC8& aType);
williamr@2
   794
	IMPORT_C TImEncodingType ContentTransferEncoding() const;
williamr@2
   795
	IMPORT_C TImEncodingType ContentTransferEncoding(TDes8& rType) const;
williamr@2
   796
	IMPORT_C const TPtrC8 GetContentTypeValue(const TDesC8& aContentTypeParameter) const;
williamr@2
   797
williamr@2
   798
	// inlines to access arrays
williamr@2
   799
	inline const CDesC8Array& ContentTypeParams() const;
williamr@2
   800
	inline const CDesC8Array& ContentDispositionParams() const;
williamr@2
   801
	inline const CDesC8Array& XTypeParams() const;
williamr@2
   802
williamr@2
   803
	inline CDesC8Array& ContentTypeParams();
williamr@2
   804
	inline CDesC8Array& ContentDispositionParams();
williamr@2
   805
	inline CDesC8Array& XTypeParams();		// anything else that is in the header, but not recognised
williamr@2
   806
williamr@2
   807
	inline const TUint16 Version() const;
williamr@2
   808
	inline void SetVersion( TUint16 aVersion );
williamr@2
   809
williamr@2
   810
	IMPORT_C void SetMimeCharset(const TUint aCharset);
williamr@2
   811
	IMPORT_C TUint MimeCharset() const;
williamr@2
   812
williamr@2
   813
private:
williamr@2
   814
	CImMimeHeader();
williamr@2
   815
	void ConstructL();
williamr@2
   816
	TBool ArrayEntryExists(CDesCArray& aArray, TInt aField);
williamr@2
   817
williamr@2
   818
private:
williamr@2
   819
	TUint16 iVersion;
williamr@2
   820
	HBufC8* iRelativePath;
williamr@2
   821
	HBufC8* iContentDescription;
williamr@2
   822
williamr@2
   823
	TImEncodingType iContentTransferEncoding;
williamr@2
   824
williamr@2
   825
	// MHTML parameters
williamr@2
   826
	HBufC8* iContentBase;
williamr@2
   827
	HBufC16* iContentLocation;
williamr@2
   828
	HBufC8* iContentID;
williamr@2
   829
	//
williamr@2
   830
	HBufC8* iContentType;
williamr@2
   831
	HBufC8* iContentSubType;
williamr@2
   832
	HBufC8* iContentDisposition;
williamr@2
   833
	//
williamr@2
   834
	CDesC8Array* iContentTypeParams;			// zero or more "parameter"
williamr@2
   835
	CDesC8Array* iContentDispositionParams;		// zero or more "parameters"
williamr@2
   836
	CDesC8Array* iXTypeParams;					// zero or more X-Type "parameters"
williamr@2
   837
	//
williamr@2
   838
	TBuf<20> iContentTransferEncodingBuffer;	// must be big enough to store "quoted-printable" string
williamr@2
   839
williamr@2
   840
	// The uid value is always used in preference to the stored string.
williamr@2
   841
	// Only when the uid is not set is the string used when sending.
williamr@2
   842
	TUint iMimeCharset;	
williamr@2
   843
	};
williamr@2
   844
williamr@2
   845
williamr@2
   846
williamr@2
   847
#include <miuthdr.inl>
williamr@2
   848
williamr@2
   849
#endif // #defined __MIUTHDR_H__