msvemailutils.h

来自「基于symbian的收发SMS、MMS消息」· C头文件 代码 · 共 110 行

#ifndef __MSVEMAILUTILS_H__
#define __MSVEMAILUTILS_H__

#include <e32base.h>
#include <msvapi.h>

class CClientMtmRegistry;
class CServerMtmDllRegistry;
class CMsvServerEntry;
class CMsvServer;

class CImap4ClientMtm;
class CPop3ClientMtm;


/*
* ============================================================================
*  Name     : CMsvEmailUtils from MsvEmailUtils.h
*  Part of  : EmailExample
*  Created  : 09/11/2003 by Forum Nokia
*  Implementation notes:
*		Common helpers for different internet email protocols
*
*  Version  : 1.0
*  Copyright: Nokia Corporation
* ============================================================================
*/

class CMsvEmailUtils : public CBase
	{
public:

// creational interface
	static CMsvEmailUtils* NewL(CMsvSession& aSession);
	static CMsvEmailUtils* NewLC(CMsvSession& aSession);
	~CMsvEmailUtils();

// operations

	/*
    * GetServiceIdL(TUid aType)
    *
    * Select first service entry of given type and return its id
    *
    * Params:
	*	(1) TUid aType		uid of of some internet email protocol type
    *
    * Returns:
    *				Returns id of first service entry of given type
    *
    */
	TMsvId GetServiceIdL(TUid aType);

	/*
    * GetFolderThenServiceIdL(TUid aType)
    *
    * Select id of first folder of first service entry of given type and
	* return its id
    *
    * Params:
	*	(1) TUid aType			uid of of some internet email protocol type
    *
    * Returns:
    *				Returns id of first service entry of given type
    *
    */
	TMsvId GetFolderThenServiceIdL(TUid aType);

	/*
    * InstantiatePopClientMtmL(TMsvId aService)
    *
    * Create a CPop3ClientMtm object and return a pointer to it.
    *
    * Params:
    *	(1) TMsvId aService		Service entry
	*
    * Returns:
    *				A pointer to the created mtm
    *
    */
	CPop3ClientMtm* InstantiatePopClientMtmL(TMsvId aService);

	/*
    * InstantiateImapClientMtmL(TMsvId aService)
    *
    * Create a CImap4ClientMtm object and return a pointer to it.
    *
    * Params:
    *	(1) TMsvId aService		Service entry
	*
    * Returns:
    *				A pointer to the created mtm
    *
    */
	CImap4ClientMtm* InstantiateImapClientMtmL(TMsvId aService);

// protected functions
protected:
	CMsvEmailUtils(CMsvSession& aSession);
	void ConstructL();
	TMsvId FindServiceL(TUid aType);
	TMsvId FindFolderThenServiceL(TUid aType);
// private data
private:
	CMsvSession& iMsvSession;
	CClientMtmRegistry* iMtmReg;
	};

#endif // __MSVEMAILUTILS_H__