Chapter 1

The CSharableSession class provides utility functions to access the server and the
current message and the CSession class provides utility functions to read and write data
between server and client address spaces.
You should implement ServiceL() to handle a message from the client. Interpret the
request code and parameters in the RMes-sage from the client; when ServiceL() is
complete, use aMes-sage.Complete() to pass a result back to the client.
Handling asynchronous client requests is more complex than handling simple, synchronous,
requests. The aMessage parameter to Servi ceL() must be stored because the next time
ServiceL() is called it will be different. Each asynchronous request supported by the
server will require an active object to service it. When the asynchronous operation is
completed, the stored RMessage must be retrieved and Complete()called on it. Note that
if the active object request function returns an error, the client request should be completed
at that point.
Note
The other functions provided by the CSharableSession API are either for
specialist use or deprecated, so I haven't described them here.
RMessage – a server-side message
When a client issues a message, it arrives at the server as an RMessage object. You can
use the functions of RMessage to access the request code and message parameters. You
also get a Client() function that returns an RThread for the client, and convenience
functions to read from, write to, panic, terminate, or kill the client thread. You call
Complete() to complete the handling of a message.
Here is the complete definition of RMessage:
class RMessage
{
public:
friend class CServer;
enum TSessionMessages EConnect = -1, EDisConnect = -2 ;
public: IMPORT_C RMessage();
IMPORT_C RMessage(const RMessage& aMessage);
IMPORT_C RMessage& operator=(const RMessage& aMessage);
IMPORT_C void Complete(TInt aReason) const;
IMPORT_C void ReadL(const TAny* aPtr, TDes8& aDes) const;
IMPORT_C void ReadL(const TAny* aPtr, TDes8& aDes, TInt
anOffset)
const;
IMPORT_C void ReadL(const TAny* aPtr, TDes16& aDes) const;
IMPORT_C void ReadL(const TAny* aPtr, TDes16& aDes, TInt
anOffset)
const;
IMPORT_C void WriteL(const TAny* aPtr, const TDesC8& aDes)
const;
IMPORT_C void WriteL(const TAny* aPtr, const TDesC8& aDes,