Collapse all Symbian^3 Application Developer Library

MRemConTargetSelectorPluginInterfaceV4 Class Reference

class MRemConTargetSelectorPluginInterfaceV4

Additional functions for TSP Interface V4

This interface must be implemented if the TSP wishes to support addressing by the bearer. Bearer addressing will always be used if supported by the bearer. When bearer addressing is used the TSP will not be given any option over which client receives a command, however if it implements this interface it has visibility of where each command goes and can reject the command if it is not acceptable.

If this interface is not implemented default implementations of these functions will be used which will allow the command to be addressed to the bearer's selected client. This means that if the TSP does not implement this interface it will not see any commands which have been addressed by the bearer.

Regardless of whether this interface is implemented commands which are not addressed by the bearer will continue to be addressed by the TSP via earlier versions of MRemConTargetSelectorPluginInterface .

Public Member Functions
void	PermitIncomingCommand ( TUid , TUint , const TClientInfo &)
void	PermitIncomingNotify ( TUid , TUint , const TClientInfo &)
void	SetRemoteAddressedClient (const TUid &, const TClientInfo &)

Member Functions Documentation

PermitIncomingCommand(TUid, TUint, const TClientInfo &)

void	PermitIncomingCommand	(	TUid	aInterfaceUid,
			TUint	aOperationId,
			const TClientInfo &	aClient
		)	[pure virtual]

Called by RemCon to get the TSP to permit an incoming command. This is called if the bearer has provided a target client for the command.

The implementor should decide if they wish to allow this command and then call IncomingCommandPermitted on the observer with a suitable error.

Parameters

TUid aInterfaceUid	The UID of the client interface.
TUint aOperationId	The operation ID of the command.
const TClientInfo & aClient	a TClientInfo referring to the selected client

PermitIncomingNotify(TUid, TUint, const TClientInfo &)

void	PermitIncomingNotify	(	TUid	aInterfaceUid,
			TUint	aOperationId,
			const TClientInfo &	aClient
		)	[pure virtual]

Called by RemCon to get the TSP to permit an incoming Notify. This is called if the bearer has provided a target client for the Notify.

The implementor should decide if they wish to allow this Notify and then call IncomingNotifyPermitted on the observer with a suitable error.

Parameters

TUid aInterfaceUid	The UID of the client interface.
TUint aOperationId	The operation ID of the Notify.
const TClientInfo & aClient	a TClientInfo referring to the selected client

SetRemoteAddressedClient(const TUid &, const TClientInfo &)

void	SetRemoteAddressedClient	(	const TUid &	aBearerUid,
			const TClientInfo &	aClient
		)	[pure virtual]

Called by RemCon when a bearer that can address commands wishes to inform the system that there has been a remote user action to select a different addressed client.

The bearer will then route addressed commands to this client until such time as SetRemoteAddressedClient is called again or the TSP calls SetLocalAddressedClient.

Parameters

const TUid & aBearerUid	The bearer that has changed its addressed client
const TClientInfo & aClient	The RemCon client that is now selected by the bearer