CSecureServer Class Reference

List of all members.

Public Member Functions
CSession2 *	NewSessionL (const TVersion &aVersion, const RMessage2 &aMessage) const
CPolicyServer::TCustomResult	CustomSecurityCheckL (const RMessage2 &aMsg, TInt &aAction, TSecurityInfo &aMissing)
CObjectCon *	NewContainerL ()
void	RemoveContainer (CObjectCon *aCon)
	~CSecureServer ()
Static Public Member Functions
static CSecureServer *	NewL (CActive::TPriority aActiveObjectPriority)
static TInt	ThreadFunction (TAny *aStarted)
static void	PanicServer (TSecureServerPanic aPanic)

---

Detailed Description

The class that represents the secure server.

The server starts when the first client connects. When the server starts, it prepares:

• the active scheduler
• the server active object
• the object container index which produces object containers for each session.

See also:

CSecureServer

Definition at line 203 of file secureserver.h.

---

Constructor & Destructor Documentation

CSecureServer::~CSecureServer

(

)

Destructor.

Definition at line 111 of file secureserverccountserver.cpp.

---

Member Function Documentation

CSession2 * CSecureServer::NewSessionL	(	const TVersion &	aVersion,
		const RMessage2 &	aMessage
	)			const

Creates a server-side session object.

Parameters:

	aVersion	The version information supplied by the client.
	aMessage	Represents the details of the client request that is requesting the creation of the session.

Definition at line 121 of file secureserverccountserver.cpp.

CSecureServer * CSecureServer::NewL

(

CActive::TPriority

aActiveObjectPriority

)

[static]

Creates a new server object and returns the handle to it.

Parameters:

aActiveObjectPriority

The priority of the secure server. The secure server is an active object. It is derived from CActive and the priority value is the priority of the active object.

See also:

CActive

Definition at line 53 of file secureserverccountserver.cpp.

TInt CSecureServer::ThreadFunction

(

TAny *

aStarted

)

[static]

The thread function that makes the server ready for use. The Symbian platform calls the function when the server thread starts to run. This is a static function, and it

• creates the server object
• creates the server’s active scheduler
• starts the server’s active scheduler

  Returns:

  KErrNone.

Parameters:

aStarted

aStarted

Definition at line 47 of file secureserver.cpp.

void CSecureServer::PanicServer

(

TSecureServerPanic

aPanic

)

[static]

Panics the server.

Parameters:

aPanic

The reason for the panic.

Definition at line 42 of file secureserverccountserver.cpp.

CPolicyServer::TCustomResult CSecureServer::CustomSecurityCheckL	(	const RMessage2 &	aMsg,
		TInt &	aAction,
		TSecurityInfo &	aMissing
	)

Performs a custom security check.

The policy server framework calls this function when a client sends requests to the server that are identified by the five enum values TSecureServerRequest::ESecureServerIncrease to TSecureServerRequest::ESecureServerReset. The request numbers match the client-side requests identified by the functions:

• RSecureSubSession::Increase();
• RSecureSubSession::Decrease();
• RSecureSubSession::IncreaseBy(TInt anInt);
• RSecureSubSession::DecreaseBy(TInt anInt);
• RSecureSubSession::Reset();

See the const arrays defined in secureserver.h. See the use of CPolicyServer::ECustomCheck in the third element in the array KSecureServerElementsIndex in secureserver.h.

Parameters:

	aMsg	The message to check.
	aAction	A reference to the action to take if the security check fails.
	aMissing	A reference to the list of security attributes missing from the checked process.

Returns:

A value from TCustomResult.

Definition at line 149 of file secureserverccountserver.cpp.

CObjectCon * CSecureServer::NewContainerL

(

)

Creates a new object container when creating sub sessions.

Returns:

An object container.

Definition at line 66 of file secureserverccountserver.cpp.

void CSecureServer::RemoveContainer

(

CObjectCon *

aCon

)

Removes an object from the object container.

Parameters:

aCon

A pointer to the object to be removed from the container.

Definition at line 75 of file secureserverccountserver.cpp.