// Copyright (c) 2005-2009 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:
//

/**
 @file
 @publishedPartner
 @released
*/

#ifndef __OBEXCLIENTERRORRESOLVER_H
#define __OBEXCLIENTERRORRESOLVER_H

#include <obexclient.h>

class MObexClientErrorResolver;

/**
Types of error set that an Obex client error can be resolved to.
*/
enum TObexClientErrorResolutionSetType
	{
	/**
	The basic error set that errors can be resolved to.
	@see TObexClientBasicErrorResolutionSet
	*/
	EObexClientBasicErrorResolutionSet = 0,
	};

/**
The basic error set that errors can be resolved to.
*/
enum TObexClientBasicErrorResolutionSet
	{
	/**
	The last client operation completed without error.
	This value is unused but remains here for compatibility.
	*/
	EObexNoExtendedError = 0,

	/**
	The last client operation completed without error.
	*/
	EObexRequestAccepted = 1,

	/**
	The last client operation was unauthorised or resulted in
	an error being returned from the server.
	*/
	EObexRequestNotAccepted = 2,

	/**
	The last client operation timed out.
	*/
	EObexRequestTimeout = 3,

	/**
	The last client operation was interrupted by an error
	detected on the client side, which includes the following:
	- Cancellation of the operation (Abort)
	- Obex protocol error
	- Out of memory condition
	*/
	EObexRequestLocalInterruption = 4,

	/**
	The last client operation was interrupted due to the
	transport link going down.  This may be caused by:
	- Failure to find a remote device capable of Obex
	- Blocking of the IrDA beam
	*/
	EObexRequestLinkInterruption = 5,
	};

/**
Extension class for CObexClient that allows Obex client applications to
retrieve an extended error code for the last completed client operation.
*/
NONSHARABLE_CLASS(CObexClientErrorResolver) : public CBase
	{
public:
	IMPORT_C static CObexClientErrorResolver* NewL(CObexClient& aClient);
	IMPORT_C static CObexClientErrorResolver* NewL(CObexClient& aClient, TObexClientErrorResolutionSetType aErrorSet);
	IMPORT_C TUint LastError() const;

private:
	// Private constructor - this class is not intended for derivation.
	CObexClientErrorResolver(CObexClient& aClient, TObexClientErrorResolutionSetType aErrorSet);
	void ConstructL();

private:
	CObexClient& iObexClient;
	MObexClientErrorResolver* iClientErrorResolver;
	TObexClientErrorResolutionSetType iErrorSet;
	};

#endif // __OBEXCLIENTERRORRESOLVER_H