Click on the following link to download the example: Ecom.zip
Download some additional files required by the example: CommonFrameworkClick: browse to view the example code.
View the additional files: browse.InterfaceDefinition provides an example ECom interface definition. It declares a base class, CExampleInterface, from which implementations of the interface should derive.
CExampleInterface provides three NewL() functions that allow clients to get respectively:
the default implementation of the interface, using a specified custom resolver to determine what is the default
an implementation determined by the default resolver, using a specified string as a resolution parameter
an implementation determined by the default resolver, using a specified string as a resolution parameter, and passing some data to the implementation
CExampleInterface uses the overloads of REComSession::CreateImplementation() to implement these functions.
CExampleInterface declares one pure virtual function, DoMethodL(), which supplies a service to the client. Implementations must implement this function.
InterfaceDefinition also provides an example of a custom resolver, called CExampleResolver. Its behaviour is the same as ECom's default resolver. Because a resolver is an implementation of the ECom CResolver interface, it requires a registration resource file (100098ea.rss), and an exported factory table (Proxy.cpp).
Building InterfaceDefinition exports the files that contain the interface definition, Interface.h and Interface.inl, to epoc32\include\; produces a DLL ExampleResolver.dll; and compiles a resource file ExampleResolver.rsc in the \resource\plugins\ directory.
Implementations of the interface are provided in the Interface Implementation example.
A client program that accesses the interface is provided in the Interface Clientexample.