#include <ecom/ecom.h>
Link against: ecom.lib
| class REComSession : public RSessionBase |
| Inherited Attributes | |
|---|---|
| RHandleBase::iHandle | |
| Inherited Enumerations | |
|---|---|
| RHandleBase:TAttributes | |
| RSessionBase:TAttachMode | |
The REComSession singleton class provides an API to identify (resolution), instantiate, and destroy interface class implementations requested by ECOM clients. It manages the session connection to the ECOM Server itself so that typically only one connection is made to the ECOM Server per thread. It provides an un-initialise function where it releases memory and handles of unused plug-ins, see the FinalClose() function. It also ensures that all necessary clean-up is performed in the event of a Leave by any of the ListImplementationsL() or CreateImplementationL() methods.
Note: Although a public default constructor is provided in this class it is strongly recommended this object is never created by users of this API on the stack or heap by value. To access the non-static methods of this API use the static OpenL() method to obtain a pointer or a reference to the single reference counted session in use. Close() must be called when finished with.
Special care must be taken when using aInstanceKey. It is a 32-bit instance key that is returned from a call to one of the CreateImplementationL() methods. This instance key must only be used with DestroyedImplementation() to identify the implementation instance for destruction, or GetImplementationUidL() to retrieve the Implementation Uid of the instance it refers to. No meaning must be attached to this instance key by ECOM clients and it must not be used for any other purpose.
See also: REComSession::FinalClose()
| IMPORT_C | REComSession | ( | ) |
| IMPORT_C void | CancelNotifyOnChange | ( | TRequestStatus & | aStatus | ) |
| Parameters | |
|---|---|
| aStatus | The request status object originally passed to NotifyOnChange() for notification signalling. |
| IMPORT_C void | Close | ( | ) |
Reimplemented from RHandleBase::Close()
Closes the open handle on the ECOM framework. Reference count is decremented and the ECOM client/server session is closed.
| Parameters | |
|---|---|
| aImplementationUid | A UID specifying the required interface implementation. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| Parameters | |
|---|---|
| aImplementationUid | A UID specifying the required interface implementation. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aImplementationUid, |
| TUid & | aInstanceKey, | |||
| TAny * | aConstructionParameters | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aImplementationUid | A UID specifying the required interface implementation. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aConstructionParameters | The parameter structure to pass to the object creation method. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aImplementationUid, |
| TInt32 | aKeyOffset, | |||
| TAny * | aConstructionParameters | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aImplementationUid | A UID specifying the required interface implementation. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aConstructionParameters | The parameter structure to pass to the object creation method. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TUid & | aInstanceKey, | |||
| const TEComResolverParams & | aResolutionParameters | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TInt32 | aKeyOffset, | |||
| const TEComResolverParams & | aResolutionParameters | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TUid & | aInstanceKey, | |||
| TAny * | aConstructionParameters, | |||
| const TEComResolverParams & | aResolutionParameters | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aConstructionParameters | The parameter structure to pass to the object creation method. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. return TAny* A pointer to the instantiated interface implementation. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TInt32 | aKeyOffset, | |||
| TAny * | aConstructionParameters, | |||
| const TEComResolverParams & | aResolutionParameters | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aConstructionParameters | The parameter structure to pass to the object creation method. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TUid & | aInstanceKey, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The Uid of a CResolver with client defined behaviour. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TInt32 | aKeyOffset, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The Uid of a CResolver with client defined behaviour. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TUid & | aInstanceKey, | |||
| TAny * | aConstructionParameters, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aConstructionParameters | The parameter structure to pass to the object creation method. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The Uid of a CResolver with client defined behaviour. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| TInt32 | aKeyOffset, | |||
| TAny * | aConstructionParameters, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aConstructionParameters | The parameter structure to pass to the object creation method. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The Uid of a CResolver with client defined behaviour. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| const RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| TUid & | aInstanceKey, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TAny * | aConstructionParameters = NULL | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface implementation. |
| aExtendedInterfaces | Identifies a set of zero or more extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aConstructionParameters | The parameter structure to pass to the object creation method. Default value is NULL. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| Or | any of the System Wide error codes |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| const RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| TInt32 | aKeyOffset, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TAny * | aConstructionParameters = NULL | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface implementation. |
| aExtendedInterfaces | Identifies a set of zero or more extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aConstructionParameters | The parameter structure to pass to the object creation method. Default value is NULL. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| Or | any of the System Wide error codes |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| const RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| TUid & | aInstanceKey, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid, | |||
| TAny * | aConstructionParameters = NULL | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface implementation. |
| aExtendedInterfaces | Identifies a set of zero or more extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aInstanceKey | A 32-bit instance key that is returned by the ECom framework. This instance key should be passed as an argument to the DestroyedImplementation() method to identify the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The Uid of a CResolver with client defined behaviour. |
| aConstructionParameters | The parameter structure to pass to the object creation method. Default value is NULL. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| Or | any of the System Wide error codes |
| IMPORT_C TAny * | CreateImplementationL | ( | TUid | aInterfaceUid, |
| const RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| TInt32 | aKeyOffset, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid, | |||
| TAny * | aConstructionParameters = NULL | |||
| ) | [static] | |||
Instantiates an interface implementation to satisfy the specified interface.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface implementation. |
| aExtendedInterfaces | Identifies a set of zero or more extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aKeyOffset | An offset to the 32 bit identifer returned by the ECom framework to identify this instance to the framework. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The Uid of a CResolver with client defined behaviour. |
| aConstructionParameters | The parameter structure to pass to the object creation method. Default value is NULL. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied. | This leave error can happen under the following conditions: 1. There is a capability mismatch between the process creating the implementation and the DLL containing the implementation 2. The plugin DLL installed on the media card was not properly installed, either the system hash value of this plugin is missing or it is inconsistent with that calculated for the plugin DLL at load time. |
| Or | any of the System Wide error codes |
| IMPORT_C void | DestroyedImplementation | ( | TUid | aInstanceKey | ) | [static] |
| Parameters | |
|---|---|
| aInstanceKey | A 32-bit instance key that is returned from a call to one of the CreateImplementationL() methods. This instance key identifies the implementation for destruction. No meaning should be attached to this instance key by ECOM clients and it should not be used for any other purpose. |
| IMPORT_C void | FinalClose | ( | ) | [static] |
This method is used in processes that have utilised the ECOM framework, it does nothing if the ECOM framework has not been initialised. Its main purpose is to release memory and close handles held on unused plug-in implementations and their associated DLLs. If is found (through reference counting) that the ECOM framework is no longer in use in the calling thread the session to the ECOM's server is also closed.
This method is called by direct users of the ECOM framework wherever possible (e.g. library, server or test code). It is safe to call it at any time outside of plug-in code as the user's scenario dictates. This maybe during a test case or just before process termination.
Note: It must never be called from within a plug-in implementations class destructor, especially following a DestroyImplementation() as there is a risk that the plug-in's supporting DLL may immediately be unloaded by the Kernel due to the closure of RLibrary handles. It can result in a KERN-EXEC if the destructor call stack is still inside the DLL that is unloaded.
Note: Processes that utilise the ECOM framework that do not use this call are at risk of a UHEAP_MARKEND generated panic in debug builds.
| IMPORT_C TAny * | GetExtendedInterfaceL | ( | const TUid & | aInstanceKey, |
| const TUid & | aExtendedInterfaceUid | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aInstanceKey | A 32-bit implementation instance key that is returned from a call to one of the CreateImplementationL() methods. ECOM uses this implementation instance key when it is passed as an argument to the DestroyedImplementation() method to identify an implementation for destruction. No meaning should be attached to this implementation instance key by ECOM clients and it should not be used for any other purpose. |
| aExtendedInterfaceUid | Identifies an interface to fetch from the plug-in instance. |
| Leave Codes | |
|---|---|
| KErrNotFound | When the supplied 32-bit implementation instance key is not recognised by ECom. |
| KErrArgument | When a null implementation instance key is passed as an argument to ECom. |
| Any | of the other System wide errors |
| Parameters | |
|---|---|
| aInstanceKey | A 32-bit implementation instance key that is returned from a call to one of the CreateImplementationL() methods. ECOM uses this implementation instance key when it is passed as an argument to the DestroyedImplementation() method to identify an implementation for destruction. No meaning should be attached to this implementation instance key by ECOM clients and it should not be used for any other purpose. |
| Leave Codes | |
|---|---|
| KErrNotFound | When the supplied 32-bit implementation instance key is not recognised by ECom. |
| KErrArgument | When a null implementation instance key is passed as an argument to ECom. |
| Any | of the other System wide errors |
| IMPORT_C void | ListExtendedInterfacesL | ( | const TUid & | aImplementationUid, |
| RExtendedInterfacesArray & | aIfInfo | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aImplementationUid | Implementation UID to fetch the extended interfaces for. |
| aIfInfo | Return value consisting of an array containing the extended interfaces. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| One | of the system-wide error codes |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| RImplInfoPtrArray & | aImplInfoArray | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| const TEComResolverParams & | aResolutionParameters, | |||
| RImplInfoPtrArray & | aImplInfoArray | |||
| ) | [static] | |||
Retrieves a list of all the implementations which satisfy the specified interface with selection restriction to the specified parameters. The aImplInfoArray on exit contains the plug-in implementations who's plug-in DLLs have sufficient capabilities to be loaded by the calling client process.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid, | |||
| RImplInfoPtrArray & | aImplInfoArray | |||
| ) | [static] | |||
Retrieves a list of all the implementations which satisfy the specified interface with selection restriction to the specified parameters. The aImplInfoArray on exit contains the plug-in implementations who's plug-in DLLs have sufficient capabilities to be loaded by the calling client process. Overload with a client provided CResolver.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The CResolver UID which identifies the resolver implementation with the required client defined behaviour. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| RImplInfoPtrArray & | aImplInfoArray, | |||
| TBool | aCapabilityCheck | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| aCapabilityCheck | A boolean value EFalse , if no capability check is required ETrue otherwise. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| const TEComResolverParams & | aResolutionParameters, | |||
| RImplInfoPtrArray & | aImplInfoArray, | |||
| TBool | aCapabilityCheck | |||
| ) | [static] | |||
Retrieves a list of all the implementations which satisfy the specified interface with selection restriction to the specified parameters.This method does not do capability check. The aImplInfoArray on exit contains the plug-in implementations .
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| aCapabilityCheck | A boolean value EFalse , if no capability check is required ETrue otherwise. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid, | |||
| RImplInfoPtrArray & | aImplInfoArray, | |||
| TBool | aCapabilityCheck | |||
| ) | [static] | |||
Retrieves a list of all the implementations which satisfy the specified interface with selection restriction to the specified parameters.This method does not do capability check. The aImplInfoArray on exit contains the plug-in implementations . Overload with a client provided CResolver.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The CResolver UID which identifies the resolver implementation with the required client defined behaviour. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| aCapabilityCheck | A boolean value EFalse , if no capability check is required ETrue otherwise. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| RImplInfoPtrArray & | aImplInfoArray | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aExtendedInterfaces | Identifies a set of zero or many extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| Or | any of the System Wide error codes |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| RImplInfoPtrArray & | aImplInfoArray | |||
| ) | [static] | |||
Retrieves a list of all the implementations which satisfy the specified interface, extended interfaces, with selection restriction to the specified parameters. The aImplInfoArray on exit contains the plug-in implementations who's plug-in DLLs have sufficient capabilities to be loaded by the calling client process.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aExtendedInterfaces | Identifies a set of zero or more extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| Or | any of the System Wide error codes |
| IMPORT_C void | ListImplementationsL | ( | TUid | aInterfaceUid, |
| RExtendedInterfacesArray & | aExtendedInterfaces, | |||
| const TEComResolverParams & | aResolutionParameters, | |||
| TUid | aResolverUid, | |||
| RImplInfoPtrArray & | aImplInfoArray | |||
| ) | [static] | |||
Retrieves a list of all the implementations which satisfy the specified interface, extended Interfaces, with selection restriction to the specified parameters. The aImplInfoArray on exit contains the plug-in implementations who's plug-in DLLs have sufficient capabilities to be loaded by the calling client process. Overload with a client provided CResolver.
See also: TEComResolverParams
| Parameters | |
|---|---|
| aInterfaceUid | A UID specifying the required interface. |
| aExtendedInterfaces | Identifies a set of zero or more extended interfaces to match. Must match all extended interfaces for a match to occur. |
| aResolutionParameters | Specifies any additional implementation characteristics to be fulfilled, maybe empty. |
| aResolverUid | The CResolver UID which identifies the resolver implementation with the required client defined behaviour. |
| aImplInfoArray | A reference to a client owned array which will be filled with interface implementation data. The array will first be cleared and all items destroyed before adding new data. |
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| KErrNotConnected | |
| KErrArgument | |
| KErrPermissionDenied | |
| Or | any of the System Wide error codes |
| IMPORT_C void | ManuallyReleaseExtendedInterfaceL | ( | const TUid & | aInstanceKey, |
| const TUid & | aExtendedInterfaceUid | |||
| ) | [static] | |||
| Parameters | |
|---|---|
| aInstanceKey | A 32-bit implementation instance key that is returned from a call to one of the CreateImplementationL() methods. ECOM uses this implementation instance key when it is passed as an argument to the DestroyedImplementation() method to identify an implementation for destruction. No meaning should be attached to this implementation instance key by ECOM clients and it should not be used for any other purpose. |
| aExtendedInterfaceUid | Identifies an extended interface to release. |
| Leave Codes | |
|---|---|
| KErrNotFound | When the supplied 32-bit implementation instance key is not recognised by ECom. |
| KErrArgument | When a null implementation instance key is passed as an argument to ECom. |
| Any | of the other System wide errors |
| IMPORT_C void | NotifyOnChange | ( | TRequestStatus & | aStatus | ) |
Registers for notification messages when the underlying ECOM registration data changes. The client must not call this api again until their request is Completed as this could result in a 'stray signal'. This api should be placed first in the RunL of an Active Object otherwise changes could be lost. RunError should be implemented to cater for any Leaves. For example, it could retry after a second if the ECom server is busy rebuilding its indexes. CancelNotifyOnChange should be called to cancel this request and should NOT be part of the RunL.
| Parameters | |
|---|---|
| aStatus | A request status object to complete for notification signalling. |
| IMPORT_C REComSession & | OpenL | ( | ) | [static] |
This method returns a reference to the singleton client/server session object maintained by the ECOM client library, referenced counted. If it does not exist it is initialised and then returned. Clients should store the handle returned by refernce or by pointer. Storage by value is highly discouraged.
It is only necessary to use the Open()/Close() API directly if you need access to the notification methods. Access to the static API does not require these to be used. Please remeber each call to Open() must have an equivalent Close().
| Leave Codes | |
|---|---|
| KErrNoMemory | |
| One | of the system-wide error codes |
| IMPORT_C void | SetGetParametersL | ( | const TIpcArgs & | aArgs | ) | [static] |
| Parameters | |
|---|---|
| aArgs | Arguments used for sending and receiving parameters |
| Leave Codes | |
|---|---|
| ... | One of the system-wide error codes |