--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/authorisation/userpromptservice/policies/source/policyevaluator.cpp	Thu Sep 10 14:01:51 2009 +0300
@@ -0,0 +1,197 @@
+/*
+* Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of the License "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: 
+*
+*/
+
+
+#include <ups/policyevaluator.h>
+#include <ups/upserr.h>
+#include <ecom/ecom.h>
+#include "upslog.h"
+
+using namespace UserPromptService;
+
+/**
+Default implementation of a policy evaluator. 
+This is returned if no policy evaluator is defined in the policy file OR
+the policy evaluator implementation UID is zero.
+*/
+NONSHARABLE_CLASS(CDefaultPolicyEvaluator) : public CPolicyEvaluator 
+	{
+public:
+	static CDefaultPolicyEvaluator* NewL();
+	
+	void GenerateFingerprints(
+		const CPromptRequest& aRequest, const CPolicy& aPolicy,
+		RPointerArray<CFingerprint>& aFingerprints, const CClientEntity*& aClientEntity, 
+		const TAny*& aDialogCreatorParams,
+		TRequestStatus& aStatus);
+	
+	// Empty implementations of CActive pure virtual functions
+	// RunL is never called because the request is completed immediately.
+	void RunL() {};
+	void DoCancel() {};
+	
+	~CDefaultPolicyEvaluator();
+	
+private:
+	CDefaultPolicyEvaluator();
+	};
+
+EXPORT_C CPolicyEvaluator::CPolicyEvaluator()
+/**
+Constructor
+*/
+: CActive(EPriorityStandard)
+	{
+	}
+
+EXPORT_C CPolicyEvaluator::~CPolicyEvaluator()
+/**
+Destructor
+*/
+	{
+	REComSession::DestroyedImplementation(iDtor_ID_Key);
+	}
+	
+EXPORT_C CPolicyEvaluator* CPolicyEvaluator::NewL(const TUid& aPolicyEvaluatorImplementationId)
+/**
+Creates a new policy evaluator.
+@param	aPolicyEvaluatorImplementationId	The UID of the policy evaluator implemenation
+											as specified in the policy file.
+
+@return A pointer to the new dialog creator implementation.
+*/
+	{
+	if (aPolicyEvaluatorImplementationId.iUid == 0)
+		{
+		DEBUG_PRINTF(_L8("Instantiating default policy evaluator"));
+		return CDefaultPolicyEvaluator::NewL();
+		}
+	
+	TAny* plugin(0);
+	DEBUG_PRINTF2(_L8("Instantiating policy evaluator 0x%08x"), aPolicyEvaluatorImplementationId);
+	TRAPD(err, plugin = 
+	REComSession::CreateImplementationL(aPolicyEvaluatorImplementationId,
+		_FOFF(CPolicyEvaluator,iDtor_ID_Key)));
+
+	if (err != KErrNone)
+		{
+		DEBUG_PRINTF3(_L8("Failed to instantiate policy evaluator 0x%08x, err = %d"),
+					  aPolicyEvaluatorImplementationId.iUid, err);
+		}
+
+	if (err == KErrNotFound)
+		{
+		err = KErrUpsMissingPolicyEvaluator;  
+		}
+	User::LeaveIfError(err);
+	return reinterpret_cast<CPolicyEvaluator*>(plugin);		
+	}
+
+/**
+If a decision record matching one of the fingerprints created by \ref CPolicyEvaluator::GenerateFingerprints
+was found then this method will be invoked. This allows the policy evaluator 
+to instruct the user prompt service to ignore the result of the decision record and prompt 
+the user.\p
+This functionality could be used to trigger periodic prompts if an application
+makes very high usage of a service e.g. after 100 SMS messages have been sent. 
+The usage could be tracked externally or via the evaluatorInfo field in the decision record.\n
+N.B. The User Prompt Service does not mandate the contents or usage of the evaluatorInfo field.
+
+- The default implementation CPolicyEvaluator::ForcePromptL always returns EFalse and does
+  not modifiy aNewEvaluatorInfo.
+
+@param	aDecision			The first decision record that matched a fingerprint generated by
+							\ref CPolicyEvaluator::GenerateFingerprints
+@param	aNewEvaluatorInfo	A reference to a copy of the evaluatorInfo field from the decision record.
+							If this method modifies this value then this field will be updated in the
+							decision record regardless of whether a prompt is required.
+@return						ETrue if a prompt should be displayed; otherwise, 
+							EFalse if the result of the decision record should be used.
+*/
+EXPORT_C TBool CPolicyEvaluator::ForcePromptL(const CDecisionRecord& aDecision, TUint& aNewEvaluatorInfo)
+	{
+	(void) aDecision;
+	(void) aNewEvaluatorInfo;
+	return EFalse;
+	}
+
+EXPORT_C TInt CPolicyEvaluator::GetExtension(TUint aExtensionId, TAny*& a0, TAny* a1)
+/**
+Allows extension of this interface. Calls Extension_
+
+@param aExtensionId		The UID of the interface to instantiate.
+@param a0				A reference to a pointer that should be set to the newly
+						instantiated object.
+@param a1				Data specific to the instantiate of the specified interface.
+
+@return KErrNone if the extension is supported or KErrNotSupported if the extension is not
+		recognised; otherwise, a system wide error may be returned.
+*/
+	{
+	return Extension_(aExtensionId, a0, a1);
+	}
+
+EXPORT_C TInt CPolicyEvaluator::Extension_(TUint aExtensionId, TAny*& a0, TAny* a1)
+	{
+	return CActive::Extension_(aExtensionId, a0, a1);
+	}
+
+CDefaultPolicyEvaluator* CDefaultPolicyEvaluator::NewL() 
+/**
+Factory method that creates a new default policy evaluator object.
+@return A pointer to the new default policy evaluator object.
+*/
+	{
+	CDefaultPolicyEvaluator* self = new(ELeave) CDefaultPolicyEvaluator();
+	return self;
+	}
+
+CDefaultPolicyEvaluator::CDefaultPolicyEvaluator()
+/**
+Constructor
+*/
+	: CPolicyEvaluator()
+	{
+	CActiveScheduler::Add(this);
+	}
+
+CDefaultPolicyEvaluator::~CDefaultPolicyEvaluator()
+/**
+Destructor
+*/
+	{
+	Deque();
+	}
+	
+void CDefaultPolicyEvaluator::GenerateFingerprints(
+	const CPromptRequest& /* aRequest */, const CPolicy& /* aPolicy */,
+	RPointerArray<CFingerprint>& aFingerprints, const CClientEntity*& /* aClientEntity */, 
+	const TAny*& /* aDialogCreatorParams */,
+	TRequestStatus& aStatus)
+/**
+Returns a single, null fingerprint and completes immediately.
+*/
+	{
+	CFingerprint* f(0);
+	TRAPD(retVal, f = CFingerprint::NewLC(KNullDesC8, KNullDesC);
+			   aFingerprints.AppendL(f); 
+			   CleanupStack::Pop(f));
+	
+	TRequestStatus *status = &aStatus;
+	*status = KRequestPending;	
+	User::RequestComplete(status, retVal);
+	}