williamr@2: /*
williamr@2: * Copyright (c) 2003-2006 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: * All rights reserved.
williamr@2: * This component and the accompanying materials are made available
williamr@2: * under the terms of the License "Eclipse Public License v1.0"
williamr@2: * which accompanies this distribution, and is available
williamr@2: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@2: *
williamr@2: * Initial Contributors:
williamr@2: * Nokia Corporation - initial contribution.
williamr@2: *
williamr@2: * Contributors:
williamr@2: *
williamr@2: * Description: 
williamr@2: *
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /** 
williamr@2: @file
williamr@2: 
williamr@2: This contains error code definitions required by clients accessing the 
williamr@2: Content Access Framework.
williamr@2: 
williamr@2: All CAF error codes lie within the range \c KErrCA_LowerLimit to 
williamr@2: \c KErrCA_UpperLimit inclusive.
williamr@2: 
williamr@2: @publishedPartner
williamr@2: @released
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: #ifndef __CAFERR_H__
williamr@2: #define __CAFERR_H__
williamr@2: 
williamr@2: #include <e32std.h>
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: This is the upper limit of the CAF error code range.
williamr@2: 
williamr@2: Example usage:
williamr@2: @code
williamr@2: if (KErrCA_LowerLimit <= err && err <= KErrCA_UpperLimit)
williamr@2: 	{
williamr@2: 	// handle CAF-specific error
williamr@2: 	}
williamr@2: @endcode
williamr@2: */
williamr@2: const TInt KErrCA_UpperLimit = -17450;
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: This is the lower limit of the CAF error code range.
williamr@2: 
williamr@2: Example usage:
williamr@2: @code
williamr@2: if (KErrCA_LowerLimit <= err && err <= KErrCA_UpperLimit)
williamr@2: 	{
williamr@2: 	// handle CAF-specific error
williamr@2: 	}
williamr@2: @endcode
williamr@2: */
williamr@2: const TInt KErrCA_LowerLimit = -17549;
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: Agent does not support the requested capability.
williamr@2: */
williamr@2: const TInt KErrCANotSupported = -17450;
williamr@2: 
williamr@2: /** 
williamr@2: Rights evaluation failed for the supplied intent. This implies that
williamr@2: rights were available, but their evaluation, in the context of
williamr@2: supplied intent, failed.
williamr@2: */
williamr@2: const TInt KErrCANoPermission = -17451; 
williamr@2: 
williamr@2: /** 
williamr@2: No rights were available for evaluation. A number of causes may
williamr@2: generate this error: Perhaps the rights were removed or lost
williamr@2: during a separate delivery
williamr@2: */
williamr@2: const TInt KErrCANoRights = -17452; 
williamr@2: 
williamr@2: /**
williamr@2: The Agent required is not present. This may occur if content
williamr@2: 'belongs' to an agent that is no longer available on the 
williamr@2: device. 
williamr@2: */
williamr@2: const TInt KErrCANoAgent = -17453;
williamr@2: 
williamr@2: /**
williamr@2: Values specified are out of range. 
williamr@2: */
williamr@2: const TInt KErrCAOutOfRange = -17454;
williamr@2: 
williamr@2: /** 
williamr@2: The rights were not available but are 'expected'. Will only be
williamr@2: returned if the agent supports this capability. 
williamr@2: */
williamr@2: const TInt KErrCAPendingRights = -17455;
williamr@2: 
williamr@2: /**
williamr@2: A request to get the content size failed because the agent was unable
williamr@2: to determine it. This error may occur on circumstances where, say, the
williamr@2: content is streamed over HTTP.
williamr@2: */
williamr@2: const TInt KErrCASizeNotDetermined = -17456;
williamr@2: 
williamr@2: /**
williamr@2: The function failed because the agent needs the client to provide another
williamr@2: file handle before the import can continue
williamr@2: */
williamr@2: const TInt KErrCANewFileHandleRequired = -17457;
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: The rights object failed an integrity check.
williamr@2: 
williamr@2: This error is returned when a client attempts an operation which requires 
williamr@2: accessing a rights object.
williamr@2: 
williamr@2: */ 
williamr@2: const TInt KErrCACorruptRights = -17458;
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: The content object failed an integrity check.
williamr@2: 
williamr@2: This error is returned when a client attempts an operation which requires 
williamr@2: accessing a content object.
williamr@2: 
williamr@2: */ 
williamr@2: const TInt KErrCACorruptContent = -17459;
williamr@2: 
williamr@2: 
williamr@2: #endif // __CAFERR_H__