PlatSec Class Reference

#include <e32cmn.h>

Link against: elocl.lib

class PlatSec

Public Member Enumerations
enum	TConfigSetting { EPlatSecEnforcement, EPlatSecDiagnotics, EPlatSecProcessIsolation, EPlatSecEnforceSysBin, EPlatSecLocked }

Public Member Functions
TInt	CapabilityCheckFail(TInt, TCapability, const char *)
TInt	CapabilityCheckFail(TInt, const TCapabilitySet &, const char *)
TInt	CapabilityCheckFail(RMessagePtr2, TCapability, const char *)
TInt	CapabilityCheckFail(RMessagePtr2, const TCapabilitySet &, const char *)
TInt	CapabilityCheckFail(TInt, TCapability)
TInt	CapabilityCheckFail(TInt, const TCapabilitySet &)
TInt	CapabilityCheckFail(RMessagePtr2, TCapability)
TInt	CapabilityCheckFail(RMessagePtr2, const TCapabilitySet &)
IMPORT_C TInt	ConfigSetting(TConfigSetting)
TInt	CreatorCapabilityCheckFail(TCapability, const char *)
TInt	CreatorCapabilityCheckFail(const TCapabilitySet &, const char *)
TInt	CreatorCapabilityCheckFail(TCapability)
TInt	CreatorCapabilityCheckFail(const TCapabilitySet &)
TInt	CreatorPolicyCheckFail(const SSecurityInfo &, const char *)
TInt	CreatorPolicyCheckFail(const SSecurityInfo &)
UIMPORT_C TInt	EmitDiagnostic()
IMPORT_C TBool	IsCapabilityEnforced(TCapability)
TInt	LoaderCapabilityViolation(const TDesC8 &, const TDesC8 &, const SCapabilitySet &)
TInt	LoaderCapabilityViolation(RProcess, const TDesC8 &, const SCapabilitySet &)
TInt	PolicyCheckFail(TInt, const SSecurityInfo &, const char *)
TInt	PolicyCheckFail(RMessagePtr2, const SSecurityInfo &, const char *)
TInt	PolicyCheckFail(RSessionBase, const SSecurityInfo &, const char *)
TInt	PolicyCheckFail(TInt, const SSecurityInfo &)
TInt	PolicyCheckFail(RMessagePtr2, const SSecurityInfo &)

Detailed Description

Class containing Platform Security related methods

Member Enumeration Documentation

Enum TConfigSetting

An enumeration used with PlatSecSetting()

Enumerator	Value	Description
EPlatSecEnforcement		Used to request the value of the PlatSecEnforcement setting
EPlatSecDiagnotics		Used to request the value of the PlatSecDiagnotics setting
EPlatSecProcessIsolation		Used to request the value of the PlatSecProcessIsolation setting
EPlatSecEnforceSysBin		Used to request the value of the PlatSecEnforceSysBin setting
EPlatSecLocked		Used to request the value of the PlatSecLocked setting

Member Function Documentation

CapabilityCheckFail ( TInt, TCapability, const char * )

TInt	CapabilityCheckFail	(	TInt	aHandle,
			TCapability	aCapability,
			const char *	aContextText
		)	[static, inline]

CapabilityCheckFail ( TInt, const TCapabilitySet &, const char * )

TInt	CapabilityCheckFail	(	TInt	aHandle,
			const TCapabilitySet &	aMissingCaps,
			const char *	aContextText
		)	[static, inline]

CapabilityCheckFail ( RMessagePtr2, TCapability, const char * )

TInt	CapabilityCheckFail	(	RMessagePtr2	aMessage,
			TCapability	aCapability,
			const char *	aContextText
		)	[static, inline]

CapabilityCheckFail ( RMessagePtr2, const TCapabilitySet &, const char * )

TInt	CapabilityCheckFail	(	RMessagePtr2	aMessage,
			const TCapabilitySet &	aMissingCaps,
			const char *	aContextText
		)	[static, inline]

CapabilityCheckFail ( TInt, TCapability )

TInt	CapabilityCheckFail	(	TInt	aHandle,
			TCapability	aCapability
		)	[static, inline]

CapabilityCheckFail ( TInt, const TCapabilitySet & )

TInt	CapabilityCheckFail	(	TInt	aHandle,
			const TCapabilitySet &	aMissingCaps
		)	[static, inline]

CapabilityCheckFail ( RMessagePtr2, TCapability )

TInt	CapabilityCheckFail	(	RMessagePtr2	aMessage,
			TCapability	aCapability
		)	[static, inline]

CapabilityCheckFail ( RMessagePtr2, const TCapabilitySet & )

TInt	CapabilityCheckFail	(	RMessagePtr2	aMessage,
			const TCapabilitySet &	aMissingCaps
		)	[static, inline]

ConfigSetting ( TConfigSetting )

IMPORT_C TInt

ConfigSetting

(

TConfigSetting

aSetting

)

[static]

A test function to return the state of a given Platform Security configuration setting.

Parameter	Description
aSetting	An enumerated value representing the required setting

CreatorCapabilityCheckFail ( TCapability, const char * )

TInt	CreatorCapabilityCheckFail	(	TCapability	aCapability,
			const char *	aContextText
		)	[static, inline]

CreatorCapabilityCheckFail ( const TCapabilitySet &, const char * )

TInt	CreatorCapabilityCheckFail	(	const TCapabilitySet &	aMissingCaps,
			const char *	aContextText
		)	[static, inline]

CreatorCapabilityCheckFail ( TCapability )

TInt

CreatorCapabilityCheckFail

(

TCapability

aCapability

)

[static, inline]

CreatorCapabilityCheckFail ( const TCapabilitySet & )

TInt

CreatorCapabilityCheckFail

(

const TCapabilitySet &

aMissingCaps

)

[static, inline]

CreatorPolicyCheckFail ( const SSecurityInfo &, const char * )

TInt	CreatorPolicyCheckFail	(	const SSecurityInfo &	aMissingCaps,
			const char *	aContextText
		)	[static, inline]

CreatorPolicyCheckFail ( const SSecurityInfo & )

TInt

CreatorPolicyCheckFail

(

const SSecurityInfo &

aMissingCaps

)

[static, inline]

EmitDiagnostic ( )

UIMPORT_C TInt

EmitDiagnostic

(

)

[static]

IsCapabilityEnforced ( TCapability )

IMPORT_C TBool

IsCapabilityEnforced

(

TCapability

aCapability

)

[static]

Tests whether a given Platform Security capability is enforced by the system.

Capabilities may not be enforced for several reasons:

The capability has been explicitly disabled on this system by use of the PlatSecDisabledCaps configuration parameter
Platform Security checks have been globally disabled by use of the EPlatSecEnforcement configuration parameter
The capability value is unknown. I.e. Is not part of the set of supported capabilities. See TCapabilitySet::SetAllSupported().

Parameter	Description
aCapability	The capability to test

Returns: A non-zero value if the capability is enforced, zero if it is not.

LoaderCapabilityViolation ( const TDesC8 &, const TDesC8 &, const SCapabilitySet & )

TInt	LoaderCapabilityViolation	(	const TDesC8 &	aImporterName,
			const TDesC8 &	aFileName,
			const SCapabilitySet &	aMissingCaps
		)	[static, inline]

LoaderCapabilityViolation ( RProcess, const TDesC8 &, const SCapabilitySet & )

TInt	LoaderCapabilityViolation	(	RProcess	aLoadingProcess,
			const TDesC8 &	aFileName,
			const SCapabilitySet &	aMissingCaps
		)	[static, inline]

PolicyCheckFail ( TInt, const SSecurityInfo &, const char * )

TInt	PolicyCheckFail	(	TInt	aHandle,
			const SSecurityInfo &	aMissing,
			const char *	aContextText
		)	[static, inline]

PolicyCheckFail ( RMessagePtr2, const SSecurityInfo &, const char * )

TInt	PolicyCheckFail	(	RMessagePtr2	aMessage,
			const SSecurityInfo &	aMissingCaps,
			const char *	aContextText
		)	[static, inline]

PolicyCheckFail ( RSessionBase, const SSecurityInfo &, const char * )

TInt	PolicyCheckFail	(	RSessionBase	aSession,
			const SSecurityInfo &	aMissingCaps,
			const char *	aContextText
		)	[static, inline]

PolicyCheckFail ( TInt, const SSecurityInfo & )

TInt	PolicyCheckFail	(	TInt	aHandle,
			const SSecurityInfo &	aMissing
		)	[static, inline]

PolicyCheckFail ( RMessagePtr2, const SSecurityInfo & )

TInt	PolicyCheckFail	(	RMessagePtr2	aMessage,
			const SSecurityInfo &	aMissingCaps
		)	[static, inline]