RRemConController Class Reference

class RRemConController : public RRemCon

The concrete session class for RemCon controllers. Controller sessions are connectionless when opened. This means that addressing of commands is done by the Target Selector Plugin (TSP). A controller may alternatively be connection-oriented, which means that addressing of commands is done using a member of the server-side session which specifies a connection to a remote device. [NB Just because a session 'points to' a connection in this way does not means that the connection necessarily exists at the bearer level or at any other level.] To make a controller session connection-oriented, call GoConnectionOriented. On success, the session's remote address member will have been set to the requested remote address. To make a session connectionless again, use GoConnectionless. On success, the remote address member will be null, indicating that the TSP will be used to address our commands. To control bearer-level connections, use ConnectBearer and DisconnectBearer. Note that real connections may, depending on the bearer, be torn down by the remote end outside of our control. Use GetConnections (and the associated notification) to get information about the current state of the real connections. Note however that the client is not _required_ to be interested in this level of control as RemCon is responsible for making sure the required connection exists at the bearer level before sending the message. The level of control mentioned is provided to the client so that it can, for instance, ensure adequate responsiveness of the first command sent. ConnectBearerCancel and DisconnectBearerCancel merely cancel interest in the corresponding request. They do not change the state of the system, bearers, connections, or member data in any other way. They operate as pure Symbian OS asynchronous cancel methods.

Inherits from

Public Member Functions
RRemConController()
IMPORT_C voidConnectBearer(TRequestStatus &)
IMPORT_C TIntConnectBearerCancel()
IMPORT_C voidDisconnectBearer(TRequestStatus &)
IMPORT_C TIntDisconnectBearerCancel()
IMPORT_C TIntGoConnectionOriented(const TRemConAddress &)
IMPORT_C TIntGoConnectionless()
Inherited Functions
RHandleBase::Attributes()const
RHandleBase::BTraceId()const
RHandleBase::Close()
RHandleBase::DoExtendedClose()
RHandleBase::Duplicate(const RThread &,TOwnerType)
RHandleBase::FullName()const
RHandleBase::FullName(TDes &)const
RHandleBase::Handle()const
RHandleBase::HandleInfo(THandleInfo *)
RHandleBase::Name()const
RHandleBase::NotifyDestruction(TRequestStatus &)
RHandleBase::Open(const TFindHandleBase &,TOwnerType)
RHandleBase::OpenByName(const TDesC &,TOwnerType,TInt)
RHandleBase::RHandleBase()
RHandleBase::RHandleBase(TInt)
RHandleBase::SetHandle(TInt)
RHandleBase::SetHandleNC(TInt)
RRemCon::Connect()
RRemCon::Connect(const TPlayerType &,const TPlayerSubType &,const TDesC8 &)
RRemCon::GetConnections(TSglQue< TRemConAddress > &)
RRemCon::NotifyConnectionsChange(TRequestStatus &)
RRemCon::NotifyConnectionsChangeCancel()
RRemCon::RRemCon(TRemConClientType)
RRemCon::Receive(TRequestStatus &,TRemConClientReceivePackage &,TDes8 &)
RRemCon::ReceiveCancel()
RRemCon::RegisterInterestedAPIs(const TDesC8 &)
RRemCon::Send(TRequestStatus &,TUid,TUint,TUint &,TRemConMessageSubType,const TDesC8 &)
RRemCon::SendCancel()
RRemCon::SendNotify(TRequestStatus &,TUid,TUint,TRemConMessageSubType,const TDesC8 &)
RRemCon::SendUnreliable(TUid,TUint,TRemConMessageSubType,const TDesC8 &)
RRemCon::Version()const
RRemCon::__DbgCheckHeap(TInt)
RRemCon::__DbgFailNext(TInt)
RRemCon::__DbgMarkEnd(TInt)
RRemCon::__DbgMarkHeap()
RSessionBase::CreateSession(RServer2,const TVersion &)
RSessionBase::CreateSession(RServer2,const TVersion &,TInt)
RSessionBase::CreateSession(RServer2,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy *,TRequestStatus *)
RSessionBase::CreateSession(const TDesC &,const TVersion &)
RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt)
RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TIpcSessionType,const TSecurityPolicy *,TRequestStatus *)
RSessionBase::CreateSession(const TDesC &,const TVersion &,TInt,TRequestStatus *)
RSessionBase::Open(RMessagePtr2,TInt,TOwnerType)
RSessionBase::Open(RMessagePtr2,TInt,const TSecurityPolicy &,TOwnerType)
RSessionBase::Open(TInt,TOwnerType)
RSessionBase::Open(TInt,const TSecurityPolicy &,TOwnerType)
RSessionBase::Send(TInt)const
RSessionBase::Send(TInt,const TIpcArgs &)const
RSessionBase::SendReceive(TInt)const
RSessionBase::SendReceive(TInt,TRequestStatus &)const
RSessionBase::SendReceive(TInt,const TIpcArgs &)const
RSessionBase::SendReceive(TInt,const TIpcArgs &,TRequestStatus &)const
RSessionBase::SetReturnedHandle(TInt)
RSessionBase::SetReturnedHandle(TInt,RHandleBase &)
RSessionBase::SetReturnedHandle(TInt,const TSecurityPolicy &)
RSessionBase::ShareAuto()
RSessionBase::ShareProtected()
Inherited Enumerations
RHandleBase:TAttributes
RSessionBase:TAttachMode
Inherited Attributes
RHandleBase::iHandle

Constructor & Destructor Documentation

RRemConController()

IMPORT_CRRemConController()

Member Functions Documentation

ConnectBearer(TRequestStatus &)

IMPORT_C voidConnectBearer(TRequestStatus &aStatus)

Establish a bearer-level connection using the information supplied in GoConnectionOriented.

Parameters

TRequestStatus & aStatusUsed by the server to indicate completion of the request.

ConnectBearerCancel()

IMPORT_C TIntConnectBearerCancel()

Cancels interest in the completion of an outstanding ConnectBearer request. Does not affect the state of the bearer-level connection.

DisconnectBearer(TRequestStatus &)

IMPORT_C voidDisconnectBearer(TRequestStatus &aStatus)

Triggers bearer-level disconnection of the connection specified in GoConnectionOriented.

Parameters

TRequestStatus & aStatusUsed by the server to indicate completion of the request.

DisconnectBearerCancel()

IMPORT_C TIntDisconnectBearerCancel()

Cancels interest in the completion of an outstanding DisconnectBearer request. Does not affect the state of the bearer-level connection.

GoConnectionOriented(const TRemConAddress &)

IMPORT_C TIntGoConnectionOriented(const TRemConAddress &aConnection)

Makes the session connection-oriented. On success, the given connection data will be used for sending commands.

Parameters

const TRemConAddress & aConnection

GoConnectionless()

IMPORT_C TIntGoConnectionless()

Makes the session connectionless. On success, the TSP will be used for sending commands.