D:/develop/v65/clients/outlook/install/output/export/funambol/clients/outlook/mainclientDll/src/include/outlook/ClientApplication.h

00001 /*
00002  * Funambol is a mobile platform developed by Funambol, Inc. 
00003  * Copyright (C) 2003 - 2007 Funambol, Inc.
00004  * 
00005  * This program is free software; you can redistribute it and/or modify it under
00006  * the terms of the GNU Affero General Public License version 3 as published by
00007  * the Free Software Foundation with the addition of the following permission 
00008  * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED
00009  * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 
00010  * WARRANTY OF NON INFRINGEMENT  OF THIRD PARTY RIGHTS.
00011  * 
00012  * This program is distributed in the hope that it will be useful, but WITHOUT
00013  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
00014  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
00015  * details.
00016  * 
00017  * You should have received a copy of the GNU Affero General Public License 
00018  * along with this program; if not, see http://www.gnu.org/licenses or write to
00019  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
00020  * MA 02110-1301 USA.
00021  * 
00022  * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 
00023  * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com.
00024  * 
00025  * The interactive user interfaces in modified source and object code versions
00026  * of this program must display Appropriate Legal Notices, as required under
00027  * Section 5 of the GNU Affero General Public License version 3.
00028  * 
00029  * In accordance with Section 7(b) of the GNU Affero General Public License
00030  * version 3, these Appropriate Legal Notices must retain the display of the
00031  * "Powered by Funambol" logo. If the display of the logo is not reasonably 
00032  * feasible for technical reasons, the Appropriate Legal Notices must display
00033  * the words "Powered by Funambol".
00034  */
00035 
00036 #ifndef INCL_CLIENTAPPLICATION
00037 #define INCL_CLIENTAPPLICATION
00038 
00044 #include "outlook/defs.h"
00045 #include "outlook/ClientFolder.h"
00046 #include "outlook/ClientItem.h"
00047 #include "outlook/ClientMail.h"
00048 #include "outlook/ClientContact.h"
00049 #include "outlook/ClientAppointment.h"
00050 #include "outlook/ClientTask.h"
00051 #include "outlook/ClientNote.h"
00052 
00053 #include <string>
00054 
00055 
00066 class ClientApplication {
00067 
00068 private:
00069 
00071     static ClientApplication* pinstance;
00072 
00074     std::wstring        version;
00076     std::wstring        programName;
00077 
00078 
00079     // Pointers to microsoft outlook objects.
00080     _ApplicationPtr                   pApp;
00081     _NameSpacePtr                     pMAPI;
00082     MAPIFolderPtr                     pFolder;
00083 
00084     // Pointer to Redemption safe objects.
00085     Redemption::IMAPIUtilsPtr         pRedUtils;
00086     Redemption::IRDOSessionPtr        rdoSession;
00087 
00088 
00089     // Internal ClientObjects: 
00090     // 'get..()' methods always return references to these objects
00091     ClientFolder*       folder;
00092     ClientMail*         mail;
00093     ClientContact*      contact;
00094     ClientAppointment*  appointment;
00095     ClientTask*         task;
00096     ClientNote*         note;
00097 
00098 
00100     HRESULT hr;
00101 
00102     void createSafeInstances();
00103 
00104 
00105 protected:
00106 
00107     // Constructor
00108     ClientApplication();
00109 
00110 
00111 public:
00112 
00113     // Method to get the sole instance of ClientApplication
00114     static ClientApplication* getInstance();
00115 
00116     // Returns true if static instance is not NULL.
00117     static bool isInstantiated();
00118 
00119     // Destructor
00120     ~ClientApplication();
00121 
00122 
00123     const std::wstring& getVersion();
00124     const std::wstring& getName();
00125     
00126 
00127     ClientFolder* getDefaultFolder     (const std::wstring& itemType);
00128     ClientFolder* getFolderFromID      (const std::wstring& folderID);
00129     ClientFolder* pickFolder           ();
00130     ClientFolder* pickFolder           (const std::wstring& itemType);
00131     ClientFolder* getFolderFromPath    (const std::wstring& itemType,   const std::wstring& path);
00132     ClientFolder* getDefaultRootFolder ();
00133     ClientFolder* getRootFolder        (const int index);
00134     ClientFolder* getRootFolderFromName(const std::wstring& folderName);
00135 
00136     ClientItem*   getItemFromID   (const std::wstring& itemID, const std::wstring& itemType);
00137 
00138 
00139     // Utility to release shared objects of Outlook session.
00140     HRESULT cleanUp();
00141 
00142     // Utility to convert an Exchange mail address into a SMTP address.
00143     std::wstring getSMTPfromEX(const std::wstring& EXAddress);
00144 
00145     // Utility to get body of a specified item (used for notes body which is protected).
00146     std::wstring getBodyFromID(const std::wstring& itemID);
00147 
00148     // Utility to retrieve the userName of current profile used.
00149     std::wstring getCurrentProfileName();
00150 
00151     // Returns true if Outlook MAPI object is logged on.
00152     const bool isLoggedOn();
00153 };
00154 
00157 #endif

Generated on Mon Feb 4 09:50:49 2008 for Funambol Outlook Plug-in Library by  doxygen 1.5.2