// Copyright (c) 2006-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
 @internalComponent
*/

#ifndef TMTPTYPEOBJECTHANDLE_H
#define TMTPTYPEOBJECTHANDLE_H

#include <e32base.h>
#include <e32std.h>
#include <mtp/tmtptypeuint32.h>
    
/**
Defines the MTP object handle type. The MTP object handle encoding comprises
the following fields.

    1. MS 8 bits - The ID of the data provider responsible for the object.
    2. LS 24 bits - A data provider unique object identifier.
    
@internalComponent
 
*/
class TMTPTypeObjectHandle : public TMTPTypeUint32
    {
public:

    TMTPTypeObjectHandle(TUint32 aId, TUint8 aDp);
    TMTPTypeObjectHandle(TMTPTypeUint32 aId, TUint8 aDp);
    TMTPTypeObjectHandle(TMTPTypeUint32 aHandle);
    
    ~TMTPTypeObjectHandle();
    
    TUint8 DpId() const;
	TUint32 DPObjectId() const;
    void SetDPHandle(TUint8 aDp);
    
    inline static TUint ObjectID( TUint32 aHandleID )
        {
        return ( (~KDpMask) & aHandleID);
        }

    inline static TUint DataProviderID( TUint32 aHandleID )
        {
        return ((KDpMask & aHandleID) >> KObjectIdWidth);
        }
    
public:

    static const TUint32    KDpMask         = 0xFF000000;
    static const TUint32    KObjectIdMax    = 0x00FFFFFF;
    static const TUint      KObjectIdWidth  = 24;
    };

#endif // TMTPTYPEOBJECTHANDLE_H