examples/Basics/ExtensionPattern/include/NumberStore_v2.h

00001 /*
00002 Copyright (c) 1997-2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
00003 
00004 Redistribution and use in source and binary forms, with or without
00005 modification, are permitted provided that the following conditions are met:
00006 
00007 * Redistributions of source code must retain the above copyright notice, this
00008   list of conditions and the following disclaimer.
00009 * Redistributions in binary form must reproduce the above copyright notice,
00010   this list of conditions and the following disclaimer in the documentation
00011   and/or other materials provided with the distribution.
00012 * Neither the name of Nokia Corporation nor the names of its contributors
00013   may be used to endorse or promote products derived from this software
00014   without specific prior written permission.
00015 
00016 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00017 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00018 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
00019 DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
00020 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
00021 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
00022 SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
00023 CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
00024 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
00025 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00026 
00027 Description: 
00028 Header file demonstrating Extension DLL pattern
00029 This is the header file declaring the CNumberStore class.
00030 This file contains both the original functions and also the functions added by
00031 the extension.  Therefore this file is modified by the extender of the API.
00032 This is v2 of the header, and includes some new functions added by the supplier to 
00033 demonstrate the def file being disrupted. 
00034 */
00035 
00036 
00037 
00038 #if !defined(__NUMBERSTORE_V2__)
00039 #define __NUMBERSTORE_V2__
00040 
00041 #include <e32std.h>
00042 #include <e32base.h>
00043 
00044 /* class CNumberStore
00045 A trivial class to own two numbers */
00046 class CNumberStore : public CBase
00047         {       
00048 public: //functions
00049         
00050         // Original functions contained in dll from supplier
00051         IMPORT_C CNumberStore ();
00052         IMPORT_C CNumberStore (TInt aNumber1, TInt aNumber2);
00053         IMPORT_C void SetNumber1 (TInt aNumber1);
00054         IMPORT_C void SetNumber2 (TInt aNumber2);
00055         IMPORT_C TInt Number1 () const;
00056         IMPORT_C TInt Number2 () const;
00057 
00058         // New functions added by DLL supplier for version 2
00059         IMPORT_C void NewOwnerFunction1();
00060         IMPORT_C void NewOwnerFunction2();
00061         IMPORT_C void NewOwnerFunction3();
00062         IMPORT_C void NewOwnerFunction4();
00063         IMPORT_C void NewOwnerFunction5();
00064         
00065         
00066         // New functions added as a product specific extension to be implemented elsewhere
00067         // AddNumbers is a "non-intrusive" function that will be fully implemented in the extension
00068         IMPORT_C TInt AddNumbers() const;
00069         // MultiplyNumbers is an "intrusive" function that will be implemented in the orginal dll as DoMultiplyNumbers
00070         IMPORT_C TInt MultiplyNumbers() const;
00071 
00072 private: //functions
00073         
00074         // DoMultiplyNumbers is the local implementation of MultiplyNumbers. Private to force all clients to call it
00075         // via the MultiplyNumbers function in the extension dll.  It must be implemented in this DLL as it needs access
00076         // to a constant which is defined in originaldll.dll
00077         IMPORT_C TInt DoMultiplyNumbers() const;
00078 
00079 private: //data
00080         TInt iNumber1;
00081         TInt iNumber2;
00082         };
00083 
00084 #endif //__NUMBERSTORE_V2__

Generated by  doxygen 1.6.2