Collapse all Symbian^3 Product Developer Library

MProtocolPresenceWatching Class Reference

class MProtocolPresenceWatching : public MXIMPBase

Interface for presence protocol watching object. Interface must be implemented by a XIMP Framework protocol plug-ins.

This interface defines actions that XIMP Framework requests from a presence protocol connection to execute presence watching related tasks.

Protocol implementation must route requests received through this interface, to same remote presence service destination, as where the parent MXIMPProtocolConnection is connected. (Here the parent MXIMPProtocolConnection means the protocol connection instance from where this interface instance was retrieved.)

MXIMPProtocolConnection

Since: S60 v3.2

Inherits from

MProtocolPresenceWatching
- MXIMPBase

Public Member Functions
void	DoSubscribePresentityGroupMembersPresenceL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)
void	DoSubscribePresentityPresenceL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)
void	DoUnsubscribePresentityGroupMembersPresenceL(const MXIMPIdentity &, TXIMPRequestId)
void	DoUnsubscribePresentityPresenceL(const MXIMPIdentity &, TXIMPRequestId)
void	DoUpdatePresentityGroupMembersPresenceSubscriptionPifL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)
void	DoUpdatePresentityPresenceSubscriptionPifL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)

Protected Member Functions
	~MProtocolPresenceWatching()

Inherited Functions
	MXIMPBase::GetInterface(TInt32,TIfGetOps)
	MXIMPBase::GetInterface(TInt32,TIfGetOps)const
	MXIMPBase::GetInterfaceId()const
	MXIMPBase::~MXIMPBase()

Inherited Enumerations
	MXIMPBase:@26
	MXIMPBase:TIfGetOps

Constructor & Destructor Documentation

~MProtocolPresenceWatching()

~MProtocolPresenceWatching

(

)

[protected, inline, virtual]

Protected destructor. MProtocolPresenceWatching instancies can't be destroyed via this interface.

Member Functions Documentation

DoSubscribePresentityGroupMembersPresenceL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)

void	DoSubscribePresentityGroupMembersPresenceL	(	const MXIMPIdentity &	aGroupId,
			const MPresenceInfoFilter &	aPif,
			TXIMPRequestId	aReqId
		)	[pure virtual]

Requests the protocol to subscribe presence information for all the presentities existing in the identified presentity group.

Parameters

const MXIMPIdentity & aGroupId	Identification of the presentity group for which members to request presence information.
const MPresenceInfoFilter & aPif	Presence information filter indicating the set of presence information to request from the presentity group members.
TXIMPRequestId aReqId	Request ID identifying the issued request.

DoSubscribePresentityPresenceL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)

void	DoSubscribePresentityPresenceL	(	const MXIMPIdentity &	aPresentityId,
			const MPresenceInfoFilter &	aPif,
			TXIMPRequestId	aReqId
		)	[pure virtual]

Requests the protocol to subscribe presence information for identified presentity.

Parameters

const MXIMPIdentity & aPresentityId	Identification of the presentity which presence information subscribe to.
const MPresenceInfoFilter & aPif	Presence information filter indicating the set of presence information to request from the presentity.
TXIMPRequestId aReqId	Request ID identifying the issued request.

DoUnsubscribePresentityGroupMembersPresenceL(const MXIMPIdentity &, TXIMPRequestId)

void	DoUnsubscribePresentityGroupMembersPresenceL	(	const MXIMPIdentity &	aGroupId,
			TXIMPRequestId	aReqId
		)	[pure virtual]

Requests the protocol to terminate presentity group members presence information subscription.

Parameters

const MXIMPIdentity & aGroupId	Identification of the presentity group which members presence subscribtion to terminate.
TXIMPRequestId aReqId	Request ID identifying the issued request.

DoUnsubscribePresentityPresenceL(const MXIMPIdentity &, TXIMPRequestId)

void	DoUnsubscribePresentityPresenceL	(	const MXIMPIdentity &	aPresentityId,
			TXIMPRequestId	aReqId
		)	[pure virtual]

Requests the protocol to terminate presentity presence information subscription.

Parameters

const MXIMPIdentity & aPresentityId	Identification of the presentity which presence subscribtion to terminate.
TXIMPRequestId aReqId	Request ID identifying the issued request.

DoUpdatePresentityGroupMembersPresenceSubscriptionPifL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)

void	DoUpdatePresentityGroupMembersPresenceSubscriptionPifL	(	const MXIMPIdentity &	aGroupId,
			const MPresenceInfoFilter &	aPif,
			TXIMPRequestId	aReqId
		)	[pure virtual]

Requests the protocol to update presence information filter (PIF) for already existing presentity group members presence subscription.

Parameters

const MXIMPIdentity & aGroupId	Identification of the presentity group for which members presence subscribtion PIF to update.
const MPresenceInfoFilter & aPif	Indicates the new set of presence information to request from the presentities. Given set may be "wider" or "narrower" than the already subscribed one.
TXIMPRequestId aReqId	Request ID identifying the issued request.

DoUpdatePresentityPresenceSubscriptionPifL(const MXIMPIdentity &, const MPresenceInfoFilter &, TXIMPRequestId)

void	DoUpdatePresentityPresenceSubscriptionPifL	(	const MXIMPIdentity &	aPresentityId,
			const MPresenceInfoFilter &	aPif,
			TXIMPRequestId	aReqId
		)	[pure virtual]

Requests the protocol to update presence information filter (PIF) for already existing presence subscription.

Parameters

const MXIMPIdentity & aPresentityId	Identification of the presentity which presence subscribtion PIF to update.
const MPresenceInfoFilter & aPif	Indicates the new set of presence information to request from the presentity. Given set may be "wider" or "narrower" than the already subscribed one.
TXIMPRequestId aReqId	Request ID identifying the issued request.