Collapse all Symbian^3 Application Developer Library

CEikAppServer Class Reference

class CEikAppServer : public CApaAppServer

Base class for all server application's servers. Server applications must derive from this class to implement their servers. These must be instantiated in an override of CEikApplication::NewAppServerL() . This class adds support for uniquely named servers over CApaAppServers.

CApaAppServer

Inherits from

CEikAppServer
- CApaAppServer
  - CPolicyServer
    - CServer2
      - CActive
        
        CBase

Public Member Functions
IMPORT_C void	ConstructL (const TDesC &)
void	ConstructUniqueL ( TUint , TUid )
IMPORT_C CApaAppServiceBase *	CreateServiceL ( TUid )
IMPORT_C TCustomResult	CreateServiceSecurityCheckL ( TUid , const RMessage2 &, TInt &, TSecurityInfo &)

Private Member Functions
IMPORT_C void	ExtensionInterface ( TUid , TAny *&)

Inherited Functions
	CActive::CActive(TInt)
	CActive::Cancel()
	CActive::Deque()
	CActive::IsActive()const
	CActive::IsAdded()const
	CActive::Priority()const
	CActive::SetActive()
	CActive::SetPriority(TInt)
	CActive::~CActive()
	CApaAppServer::CApaAppServer()
	CApaAppServer::CustomSecurityCheckL(const RMessage2 &,TInt &,TSecurityInfo &)
	CApaAppServer::DoConnect(const RMessage2 &)
	CApaAppServer::NotifyServerExit(TInt)
	CApaAppServer::~CApaAppServer()
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CPolicyServer::CPolicyServer(TInt,const TPolicy &,TServerType)
	CPolicyServer::CheckFailedL(const RMessage2 &,TInt,const TSecurityInfo &)
	CPolicyServer::CustomFailureActionL(const RMessage2 &,TInt,const TSecurityInfo &)
	CPolicyServer::Extension_(TUint,TAny &,TAny )
	CPolicyServer::ProcessError(const RMessage2 &,TInt)
	CPolicyServer::ProcessL(const RMessage2 &)
	CServer2::CServer2(TInt,TServerType)
	CServer2::DoCancel()
	CServer2::Message()const
	CServer2::ReStart()
	CServer2::Server()const
	CServer2::SetMaster(const CServer2 *)
	CServer2::SetPinClientDescriptors(TBool)
	CServer2::Start(const TDesC &)
	CServer2::StartL(const TDesC &)
	CServer2::~CServer2()

Inherited Enumerations
	CActive:TPriority
	CPolicyServer:TCustomResult
	CPolicyServer:TFailureAction
	CPolicyServer:TSpecialCase
	CServer2:TPanic
	CServer2:TServerType

Private Attributes
TInt	iCEikAppServer_Spare1

Inherited Attributes
	CActive::iStatus
	CServer2::iSessionIter

Member Functions Documentation

ConstructL(const TDesC &)

IMPORT_C void

ConstructL

(

const TDesC &

aFixedServerName

)

[virtual]

CEikAppServer's override of CApaAppServer::ConstructL() . Classes which further derive from this one must base-call.

Parameters

const TDesC & aFixedServerName

- the name that this server will use.

ConstructUniqueL(TUint, TUid)

void	ConstructUniqueL	(	TUint	aServerDifferentiator,
			TUid	aAppUid
		)

Constructs a uniquely named instantiation of a server

Parameters

TUint aServerDifferentiator	Auto generated identifier
TUid aAppUid	UID of server application.

CreateServiceL(TUid)

IMPORT_C CApaAppServiceBase *

CreateServiceL

(

TUid

aServiceType

)

const [virtual]

CEikAppServer's override of CApaAppServer::CreateServiceL() . This allows uikon to create standard services. Classes which further derive from this one must base-call.

Parameters

TUid aServiceType

The UID of the service that the client wants to connect to.

CreateServiceSecurityCheckL(TUid, const RMessage2 &, TInt &, TSecurityInfo &)

IMPORT_C TCustomResult	CreateServiceSecurityCheckL	(	TUid	aServiceType,
			const RMessage2 &	aMsg,
			TInt &	aAction,
			TSecurityInfo &	aMissing
		)	[virtual]

Function to allow security checks on the client before they connect to a service. Server apps should override this method if they want to restict connections to some services to clients with particular capabilities. CPolicyServer

Parameters

TUid aServiceType	The UID of the service that the client wants to connect to.
const RMessage2 & aMsg	The message to check.
TInt & aAction	A reference to the action to take if the security check fails. This is either a value from TFailureAction or a negative value which has meaning to the CustomFailureActionL() method of a derived class. The policy server framework gives this value a default of EFailClient. If a derived implementation wishes a different value, then it should change this.
TSecurityInfo & aMissing	A reference to the list of security attributes missing from the checked process. The policy server initialises this object to zero (that is a sid of 0, a vid of 0, and no capabilities). If derived implementations wish to take advantage of a list of missing attributes in their implementation of CustomFailureActionL(), then they should set those missing attributes here in CustomSecurityCheckL().

ExtensionInterface(TUid, TAny *&)

IMPORT_C void	ExtensionInterface	(	TUid	aInterfaceId,
			TAny *&	aImplementaion
		)	[private, virtual]

Extension mechanism - for internal BC proofing.

Parameters

TUid aInterfaceId
TAny *& aImplementaion

Member Data Documentation

TInt iCEikAppServer_Spare1

TInt

iCEikAppServer_Spare1

[private]