--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/commondrm/drmutility/inc/drmuierrorhandling.h Thu Dec 17 08:52:27 2009 +0200
@@ -0,0 +1,200 @@
+/*
+* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "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: Implementation class header of MDrmErrorHandling API
+*
+*/
+
+
+#ifndef C_CDRMUIERRORHANDLING_H
+#define C_CDRMUIERRORHANDLING_H
+
+#include <e32base.h>
+#include <f32file.h>
+#include <caf/caftypes.h>
+#include <drmerrorhandling.h>
+
+namespace DRM
+{
+
+ //*** forward declarations go here:
+ class CDrmUiHandlingImpl;
+ class MDrmHandleErrorObserver;
+
+/**
+ * Implementation class for the MDrmErrorHandling interface
+ * For DRM UI Handling
+ *
+ * @lib drmuihandling.lib
+ * @since S60 v5.0
+ */
+NONSHARABLE_CLASS( CDrmUiErrorHandling ) :
+ public CBase, public MDrmErrorHandling
+ {
+public:
+
+ /**
+ * Two-phased constructor.
+ * @param aImplementation pointer to the implementation class
+ */
+ IMPORT_C static CDrmUiErrorHandling* NewL(
+ CDrmUiHandlingImpl* aImplementation );
+
+ /**
+ * Two-phased constructor. Leaves the created object into the
+ * cleanup stack
+ * @param aImplementation pointer to the implementation class
+ */
+ IMPORT_C static CDrmUiErrorHandling* NewLC(
+ CDrmUiHandlingImpl* aImplementation );
+ /**
+ * Destructor.
+ */
+ virtual ~CDrmUiErrorHandling();
+
+
+public: // from base class MDrmErrorHandling
+
+ /**
+ * From MDrmErrorHandling
+ *
+ * Handles DRM error situations related to invalid rights.
+ * This method displays appropriate notes, which observer can override,
+ * to the user and acquires new rights if needed. Asynchronous version,
+ * all errors are signalled using request status.
+ *
+ * @since S60 v5.0
+ * @param[in] aFile file for which the error happened
+ * @param[in] aIntent the CAF intent which was used to recieve
+ * the error
+ * @param[in] aError error code
+ * @param[in] aObserver reference to observer
+ *
+ * @return Operation Identifier for the async request
+ * required for cancelling an operation and
+ * identifying which request has been completed
+ *
+ * @see MDrmHandleErrorObserver
+ * @see ContentAccess::TIntent
+ */
+ virtual TInt HandleErrorAsyncL(
+ RFile& aFile,
+ ContentAccess::TIntent aIntent,
+ TInt aError,
+ MDrmHandleErrorObserver& aObserver );
+
+ /**
+ * From MDrmErrorHandling
+ *
+ * Handles DRM error situations related to invalid rights.
+ * This method displays appropriate notes, which observer can override,
+ * to the user and acquires new rights if needed. Synchronous version,
+ * leaves in case of error.
+ *
+ * @since S60 v5.0
+ * @param[in] aFile file for which the error happened
+ * @param[in] aIntent the CAF intent which was used to recieve
+ * the error
+ * @param[in] aError error code
+ * @param[in] aObserver pointer to observer, NULL if no observer
+ *
+ * @leave KErrArgument File is not DRM protected.
+ *
+ * @see MDrmHandleErrorObserver
+ * @see ContentAccess::TIntent
+ */
+ virtual void HandleErrorL(
+ RFile& aFile,
+ ContentAccess::TIntent aIntent,
+ TInt aError,
+ MDrmHandleErrorObserver* aObserver );
+
+ /**
+ * From MDrmErrorHandling
+ *
+ * Handles DRM error situations related to invalid rights.
+ * This method displays appropriate notes, which observer can override,
+ * to the user and acquires new rights if needed. Asynchronous version,
+ * all errors are signalled using request status.
+ *
+ * @since S60 v5.0
+ * @param[in] aFile content for which the error happened
+ * @param[in] aIntent the CAF intent which was used to recieve
+ * the error
+ * @param[in] aError error code
+ * @param[in] aObserver reference to observer
+ *
+ * @return Operation Identifier for the async request
+ * required for cancelling an operation and
+ * identifying which request has been completed
+ *
+ * @see MDrmHandleErrorObserver
+ * @see ContentAccess::TIntent
+ */
+ virtual TInt HandleErrorAsyncL(
+ ContentAccess::CData& aFile,
+ ContentAccess::TIntent aIntent,
+ TInt aError,
+ MDrmHandleErrorObserver& aObserver );
+
+ /**
+ * From MDrmErrorHandling
+ *
+ * Handles DRM error situations related to invalid rights.
+ * This method displays appropriate notes, which observer can override,
+ * to the user and acquires new rights if needed. Synchronous version,
+ * leaves in case of error.
+ *
+ * @since S60 v5.0
+ * @param[in] aFile content for which the error happened
+ * @param[in] aIntent the CAF intent which was used to recieve
+ * the error
+ * @param[in] aError error code
+ * @param[in] aObserver pointer to observer, NULL if no observer
+ *
+ * @leave KErrArgument File is not DRM protected.
+ *
+ * @see MDrmHandleErrorObserver
+ * @see ContentAccess::TIntent
+ */
+ virtual void HandleErrorL(
+ ContentAccess::CData& aFile,
+ ContentAccess::TIntent aIntent,
+ TInt aError,
+ MDrmHandleErrorObserver* aObserver );
+
+
+private:
+
+ /**
+ * C++ constructor
+ */
+ CDrmUiErrorHandling();
+
+ /**
+ * Second phase constructor
+ */
+ void ConstructL( CDrmUiHandlingImpl* aImplementation );
+
+private: // data
+
+ /**
+ * Pointer to the implementation class
+ * Not own.
+ */
+ CDrmUiHandlingImpl* iImplementation;
+ };
+
+}
+
+#endif // C_CDRMUIERRORHANDLING_H