williamr@2: // Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@4: // under the terms of "Eclipse Public License v1.0"
williamr@2: // which accompanies this distribution, and is available
williamr@4: // 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: #ifndef OBEX_PANICS_H
williamr@2: #define OBEX_PANICS_H
williamr@2: 
williamr@2: /**
williamr@2: @file
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: This file contains details of all OBEX and OBEX Transport panics which may be raised
williamr@2: as a result programming error by the users of OBEX (e.g. Client or Server Application
williamr@2: or a proprietry transport controller).
williamr@2: 
williamr@2: Internal panic codes should not be raised due to user errors but would reflect
williamr@2: internal Obex programming errors - see inc/obexfaults.h
williamr@2: */
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: Category for Obex panics
williamr@2: @see TObexPanicCode
williamr@2: */
williamr@2: _LIT(KObexPanicCategory, "Obex");
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: All Obex panics which may be raised as a result of a client (i.e. external) programming error.
williamr@2: Internal Obex panics are errors listed in TObexFaultCode
williamr@2: @see TObexFaultCode
williamr@2: */
williamr@2: enum TObexPanicCode
williamr@2: 	{
williamr@2: 	/** A NULL value was supplied for the data buffer.  Note that this
williamr@2: 	pointer can refer to either a memory buffer or a pointer to a RFile object.
williamr@2:  	@see CObexBufObject
williamr@2:  	*/
williamr@2: 	ENullPointer					= 0,
williamr@2: 	
williamr@2: 	
williamr@2: 	/** The supplied buffer is of zero length.
williamr@2: 	@see CObexBufObject
williamr@2: 	*/
williamr@2: 	EEmptyBuffer					= 1,
williamr@2: 	
williamr@2: 	
williamr@2: 	/** The header is not of the requested type.
williamr@2: 	@see CObexHeader
williamr@2: 	*/
williamr@2: 	EHeaderAsBadType				= 2,
williamr@2: 	
williamr@2: 	
williamr@2: 	/** An unknown TFileBuffering value was supplied.
williamr@2:  	@see CObexBufObject
williamr@2:  	*/
williamr@2: 	EInvalidBufferStrategy			= 3,
williamr@2: 	
williamr@2: 	
williamr@2:  	/** The RFile object does not point to a valid (open) file.
williamr@2:  	@see CObexBufObject
williamr@2:  	*/
williamr@2:  	ENullFileHandle					= 4,
williamr@2:  	
williamr@2:  	
williamr@2:  	/** An unknown TObexBufferingDetails object was supplied to a buffer object.
williamr@2:  	@see CObexBufObject
williamr@2:  	*/
williamr@2:  	EInvalidBufferDetails			= 5,
williamr@2:  	
williamr@2:  	
williamr@2: 	/** A call has been made to CObexServer::RequestIndicationCallback when no
williamr@2: 	asynchronous request is outstanding.
williamr@2: 	@see MObexNotifyAsync
williamr@2: 	@see CObexServer
williamr@2: 	*/
williamr@2: 	ENoNotificationToComplete		= 6,
williamr@2: 
williamr@2: 
williamr@2: 	/** A call has been made to CObexServer::Start when an asynchronous request
williamr@2: 	is outstanding.
williamr@2: 	@see MObexNotifyAsync
williamr@2: 	@see CObexServer
williamr@2: 	*/
williamr@2: 	EChangeInterfaceDuringWait		= 7,
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2:  	/** An invalid packet process event has been signalled.
williamr@2: 	*/
williamr@2: 	EBadPacketProcessEvent			= 8,
williamr@2: 
williamr@2: 
williamr@2: 	/** An event is available for signalling, but there is no observer set.
williamr@2: 	*/
williamr@2: 	ENoPacketProcessObserverSet		= 9,
williamr@2: 	
williamr@2: 	/** In CObexServer, a call has been made to RequestCompleteIndicationCallback(TObexResponse)
williamr@2: 	or RequestIndicationCallback(TObexResponse) with invalid response code or 
williamr@2:     RequestCompleteIndicationCallback(TInt) with invalid Symbian error code
williamr@2: 	*/
williamr@2: 	EInvalidResponseCodeFromServerApp = 10,
williamr@2: 	
williamr@2: 	/** In CObexServer, RequestCompleteIndicationCallback has been called in response to Put/GetRequestIndication
williamr@2: 	or ReuqestIndicationCallback has been called in response to Put/GetComplete or SetPath Indication
williamr@2: 	*/
williamr@2: 	EInvalidResponseCallback = 11,
williamr@2: 
williamr@2: 	/** The last server response code has been requested prior to a response from the server.
williamr@2: 	*/
williamr@2: 	ENoResponseCodeToReturn			= 12,
williamr@2: 
williamr@2: 	/** Adding End of Body header when there is data in the object. 
williamr@2: 	*/
williamr@2: 	EAddingInvalidEoBHeader = 13,
williamr@2: 	
williamr@2: 	/** A user has requested to override the handling of a request
williamr@2: 	packet at an invalid time.
williamr@2: 	*/
williamr@2: 	EOverrideRequestHandlingInBadState = 14,
williamr@4: 	
williamr@4: 	/** A pointer must be null before constructing the object it points to.
williamr@4: 	*/
williamr@4: 	ENotNullPointer = 15,
williamr@2: 	};
williamr@2: 
williamr@2: 
williamr@2: 
williamr@2: /** 
williamr@2: The category for obex transport panics
williamr@2: */
williamr@2: _LIT(KObexTransportPanicCat, "ObexTransPanics");
williamr@2: 
williamr@2: /**
williamr@2: Obex transport panics raised as a result of client programming error
williamr@2: */
williamr@2: enum TObexTransportPanicCode
williamr@2: 	{
williamr@2: 	/**
williamr@2: 	The number of transport implementations for a given transport name is more than what is allowed.  
williamr@2: 	Check that there is not more than the allowed number of plugin resource files containing the same default
williamr@2: 	data and inteface uid.
williamr@2: 	*/
williamr@2:  	EInvalidNumberOfTransportImplementations	= 0,	
williamr@2: 	};
williamr@2: 
williamr@2: #endif
williamr@4: