MXIMPProtocolPluginHost Class Reference

class MXIMPProtocolPluginHost : public MXIMPBase

Interface for XIMP Protocol Plugin host. This interface is implemented by XIMP Framework.

XIMP Protocol Plugin host interface defines actions that a XIMP protocol plug-in can request (callback) from XIMP Framework.

Inherits from

Constructor & Destructor Documentation

~MXIMPProtocolPluginHost()

~MXIMPProtocolPluginHost()[protected, inline, virtual]

Protected destructor. XIMP Protocol Plugin host instancies can't be destroyed via this interface.

Member Functions Documentation

HandleRequestCompleted(TXIMPRequestId, TInt)

voidHandleRequestCompleted(TXIMPRequestIdaReqId,
TIntaResultCode
)[pure virtual]

Notifies XIMP Framework that XIMP protocol plug-in has completed (successfully or otherwise) the request handling.

NOTE: This method isn't yet supported by XIMP Framework, since all MXIMPProtocolPlugin methods are currently synchronous.

Parameters

TXIMPRequestId aReqIdRequest ID identifying the request which handling is completed. This must equal to value given in the processing initiation. If no pending XIMP protocol plug-in request is found with this ID, plug-in is paniced.
TInt aResultCodeResult code from request handling.

HandleRequestCompleted(TXIMPRequestId, MXIMPStatus *)

voidHandleRequestCompleted(TXIMPRequestIdaReqId,
MXIMPStatus *aResult
)[pure virtual]

Notifies XIMP Framework that XIMP protocol plug-in has completed (successfully or otherwise) the request handling.

NOTE: This method isn't yet supported by XIMP Framework, since all MXIMPProtocolPlugin methods are currently synchronous.

Parameters

TXIMPRequestId aReqIdRequest ID identifying the request which handling is completed. This must equal to value given in the processing initiation. If no pending XIMP protocol plug-in request is found with this ID, plug-in is paniced.
MXIMPStatus * aResultStatus object describing result from request handling. Object ownership is transfered always to XIMPFw. NULL value not allowed.

HandleRequestCompleted(TXIMPRequestId, MXIMPStatus *, MXIMPBase *)

voidHandleRequestCompleted(TXIMPRequestIdaReqId,
MXIMPStatus *aResult,
MXIMPBase *aParameter
)[pure virtual]

Notifies XIMP Framework that XIMP protocol plug-in has completed (successfully or otherwise) the request handling.

NOTE: This method isn't yet supported by XIMP Framework, since all MXIMPProtocolPlugin methods are currently synchronous.

Parameters

TXIMPRequestId aReqIdRequest ID identifying the request which handling is completed. This must equal to value given in the processing initiation. If no pending XIMP protocol plug-in request is found with this ID, plug-in is paniced.
MXIMPStatus * aResultStatus object describing result from request handling. Object ownership is transfered always to XIMPFw. NULL value not allowed.
MXIMPBase * aParameterAdditional request complete parameters. NULL if no additional parameters to transfer XIMPFw. Parameter may be single MXIMPBase derived object or MXIMPRestrictedObjectCollection object containing multiple objects. Ownership of given parameter (also the container and contained objects) is transfered always to XIMPFw.

ObjectFactory()

MXIMPObjectFactory &ObjectFactory()[pure virtual]

Gets reference to object factory interface.

Returned object factory interface is used to instantiate XIMP data objects.