// Copyright (c) 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 apmstd.h

*

* @internalComponent

* @released

*/

#if !defined (__APMSTD_H__)

#define __APMSTD_H__

#include "commontypes.h"

/**

@publishedAll

@released

The largest possible value for a TInt16.

*/

const TInt KMaxTInt16=0x7fff;

/**

@publishedAll

@released

The smallest possible value for a TInt16.

*/

const TInt KMinTInt16=(-32768);

/**

@publishedAll

@released

*/

const TInt KMaxDataTypeLength=256;

/** Defines the priority associated with a data type.

The priority is used by a device to resolve the current preferred handler 

of a data type, in the absence of any user preferences.

@publishedAll

@released

@see TDataTypeWithPriority */

typedef TInt32 TDataTypePriority;

/** Reserved for future use. 

@publishedAll

@released */

const TInt32 KDataTypePriorityUserSpecified=KMaxTInt16;

/** Trusted applications may use this priority value to ensure 

    their MIME type associations cannot be overridden by 

    self signed (untrusted) applications.

@publishedAll

@released

@see TDataTypeWithPriority */

const TInt32 KDataTypePriorityTrustedHigh = 0xC000;

/** This is Threshold priority for Un-Trusted apps i.e., for the applications which reside 

in \\private\\10003a3f\\import\\apps and have a SID which is in the unprotected range. This is to avoid Un-Trusted app's claiming for priority higher 

than the threshold, if they claim for priority higher than the Threshold then it would be 

reduced to KDataTypeUnTrustedPriorityThreshold.

@publishedAll

@released */

const TInt32 KDataTypeUnTrustedPriorityThreshold=KMaxTInt16;

/** A priority value associated with a data (MIME) type. Associating an application 

with a data type at this priority means that this application, and no other, 

should ever handle the data type. Use sparingly.

@publishedAll

@released

@see TDataTypeWithPriority */

const TInt32 KDataTypePriorityHigh=10000;

/** A priority value associated with a data (MIME) type. Associating an application 

with a data type at this priority means that the data type is the primary 

type for that application. For example, "text/plain" files for a text editor.

@publishedAll

@released

@see TDataTypeWithPriority */

const TInt32 KDataTypePriorityNormal=0;

/** A priority value associated with a data (MIME) type. Associating an application 

with a data type at this priority means that the data type is a secondary 

type for that application. For example, "text/plain" files for a web browser.

@publishedAll

@released

@see TDataTypeWithPriority */

const TInt32 KDataTypePriorityLow=-10000;

/** A priority value associated with a data (MIME) type. Associating an application 

with a data type at this priority means that the data type is a last resort 

for that application. Use sparingly.

@publishedAll

@released

@see TDataTypeWithPriority */

const TInt32 KDataTypePriorityLastResort=-20000;

/** Reserved for future use. 

@publishedAll

@released */

const TInt32 KDataTypePriorityNotSupported=KMinTInt16;

/** This is a special priority that overrides any user settings. Applications must

have EWriteDeviceData to use this priority. If they have not then they will be

downgraded to KDataTypePriorityNormal.

@publishedPartner

@released

@see TDataTypeWithPriority */

const TInt32 KDataTypePrioritySystem = 0xFFF9;

/** A data type.

The class maintains a string that describes the data type and an associated 

UID.

A data type is also referred to as a MIME type. 

@publishedAll

@released */

class TDataType

	{

public:

	 TDataType();

	 ~TDataType();

	 TDataType(const PtrC8* aDataType);

     Ptr8* GetDataType();

private:

	Ptr8* iDataType;

	TUid iUid;

	};

class TDataTypeWithPriority

/** A data (MIME) type and a priority value for that data type.

The priority is used to resolve the current preferred handler of a data type, 

in the absence of any user preferences. An AIF file can associate an application 

with a data (MIME) type that is not native to Symbian OS. A priority value 

can be specified that allows the device to choose the highest priority application 

that can handle that data type.

@publishedAll 

@released 

@see TDataType

@see TDataTypePriority */

	{

public:

	 TDataTypeWithPriority();

	 TDataTypeWithPriority(const TDataType& aDataType, TDataTypePriority aPriority);

public:

	/** The data type. */

	TDataType iDataType;

	/** The priority value. */

	TDataTypePriority iPriority;

	};

#endif