CS000834 - ECom: Using ECom component

From Forum Nokia Wiki

ID	CS000834	Creation date	February 28, 2008
Platform	S60 3rd Edition, FP1	Tested on devices	Nokia N95
Category	Symbian C++	Subcategory	Base/System

Keywords (APIs, classes, methods, functions): REComSession, TEComResolverParams

Overview

This code snippet demonstrates how to use an ECom component.

Preconditions and important issues

An application that loads an ECom component must call REComSession::FinalClose() in its destructor. It signals the destruction of the interface implementation to ECom.

MMP file

...
 
USERINCLUDE   .
SYSTEMINCLUDE \Epoc32\include
SYSTEMINCLUDE \Epoc32\include\ecom
 
...
 
LIBRARY       ecom.lib

Source file

TBuf<50> string;
 
// Create the ECom implementation
CHelloEcomIF* ecom = CHelloEcomIF::NewL();
CleanupStack::PushL(ecom);
 
// Call ECom
ecom->SayHello(string);
 
// Delete ECom
CleanupStack::PopAndDestroy(ecom);
 
// Close ECom
REComSession::FinalClose();

PKG file

...
 
; The ECom component
"Epoc32\release\gcce\urel\EComExample.dll"
        - "!:\sys\bin\EComExample.dll"
"Epoc32\data\z\resource\plugins\EComExample.rsc"
        - "!:\resource\plugins\EComExample.rsc"

Postconditions

The application loads the existing ECom component and calls its interface.

Community: Wiki