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 */ 00029 00030 00031 #ifndef _CEXAMPLEINTERFACE__ 00032 #define _CEXAMPLEINTERFACE__ 00033 00034 #include <e32base.h> 00035 #include <ecom.h> 00036 #include <badesca.h> 00037 00038 // UID of this interface 00039 const TUid KCExampleInterfaceUid = {0x10009DC0}; 00040 00051 class CExampleInterface : public CBase 00052 { 00053 public: 00054 // The interface for passing initialisation parameters 00055 // to the derived class constructor. 00056 struct TExampleInterfaceInitParams 00057 { 00058 TInt integer; 00059 const TDesC* descriptor; 00060 }; 00061 00062 // Instantiates an object of this type 00063 static CExampleInterface* NewL(); 00064 00065 // Instantiates an object of this type 00066 // using the aMatchString as the resolver parameters. 00067 static CExampleInterface* NewL(const TDesC8& aMatchString); 00068 00069 // Instantiates an object of this type 00070 // using the aMatchString as the resolver parameters 00071 // and passing the aParams parameters 00072 static CExampleInterface* NewL(const TDesC8& aMatchString, TExampleInterfaceInitParams& aParams); 00073 00074 // Destructor. 00075 virtual ~CExampleInterface(); 00076 00077 // Request a list of all available implementations which 00078 // satisfy this given interface. 00079 static void ListAllImplementationsL(RImplInfoPtrArray& aImplInfoArray); 00080 00081 // Pure interface method 00082 // Representative of a method provided on the interface by 00083 // the interface definer. 00084 virtual void DoMethodL(TDes& aString) = 0; 00085 00086 protected: 00087 //Default c'tor 00088 inline CExampleInterface(); 00089 00090 private: 00091 // Unique instance identifier key 00092 TUid iDtor_ID_Key; 00093 }; 00094 00095 #include "interface.inl" 00096 00097 #endif 00098