examples/ForumNokia/EComCalculator/interface/EComInterfaceDefinition.inl

/*
 * Copyright (c) 2003-2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
 *    
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *    
 *  * Redistributions of source code must retain the above copyright notice, this
 *    list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 *  * Neither the name of Nokia Corporation nor the names of its contributors
 *    may be used to endorse or promote products derived from this software
 *    without specific prior written permission.
 *    
 *    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 *    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 *    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 *    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
 *    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 *    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 *    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 *    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 *    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *    
 *    Description:  
 */

// Interface's (abstract base class's) destructor
inline CCalculationInterfaceDefinition::~CCalculationInterfaceDefinition()
    {
    // If in the NewL some memory is reserved for member data, it must be
    // released here. This interface does not have any instance variables so
    // no need to delete anything.

    // Inform the ECOM framework that this specific instance of the
    // interface has been destroyed.
    REComSession::DestroyedImplementation(iDtor_ID_Key);
    }

// Interface's (abstract base class's) static factory method implementation.
// Asks ECOM plugin framework to instantiate appropriate concret plugin
// implementation.
inline CCalculationInterfaceDefinition*
    CCalculationInterfaceDefinition::NewL(const TDesC8& aOperationName)
    {
    // In this example the aOperationName name can be either "sum" or
    // "multiply". Implementations define recognition data in their
    // "default_data" section of the resource, so that resolver can decide,
    // which implementation to choose. For an example resource definition, see
    //     ..\plugin\101F5465.rss
    // This NewL uses default resolver, which just compares given
    // aOperationName and default_data string in the implementation
    // resource file.

    // Define options, how the default resolver will find appropriate
    // implementation.
    TEComResolverParams resolverParams;
    resolverParams.SetDataType(aOperationName);
    resolverParams.SetWildcardMatch(ETrue);     // Allow wildcard matching

    // Find implementation for our interface.
    // - KCalculateInterfaceDefinitionUid is the UID of our custom ECOM
    //   interface. It is defined in EComInterfaceDefinition.h
    // - This call will leave, if the plugin architecture cannot find
    //   implementation.
    // - The returned pointer points to one of our interface implementation
    //   instances.
    TAny* ptr = REComSession::CreateImplementationL(
        KCalculateInterfaceDefinitionUid,
        _FOFF(CCalculationInterfaceDefinition,iDtor_ID_Key),
                // _FOFF specifies offset of iDtor_ID_Key so that
                // ECOM framework can update its value.
        resolverParams);

    // The type of TAny* ptr should be CCalculationInterfaceDefinition.
    return REINTERPRET_CAST(CCalculationInterfaceDefinition*, ptr);
    }

---