| 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 &) |
| 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.
| 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 |
| 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.
| 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 |
| 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.
| const TUid & aBearerUid | The bearer that has changed its addressed client |
| const TClientInfo & aClient | The RemCon client that is now selected by the bearer |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.