1 /*

     2 * Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Defines an interface to extend DRM to support and validate non 

    15 *                standard DRM individual constraints (i.e. constraints other than 

    16 *                "IMSI:" or "WIM:")

    17 *

    18 */

    19 

    20 

    21 #ifndef __DRMINDIVIDUALCONSTRAINTEXTENSION_H__

    22 #define __DRMINDIVIDUALCONSTRAINTEXTENSION_H__

    23 

    24 // INCLUDES

    25 #include <e32base.h>

    26 

    27 // CONSTANTS

    28 _LIT(KDRMIndividualConstraintExtensionDll,"z:\\sys\\bin\\DRMIndividualConstraintExtension.dll");

    29 

    30 // FORWARD DECLARATIONS

    31 class RMobilePhone;

    32 

    33 // CLASS DECLARATION

    34 

    35 /**

    36 *  Defines an interface to extend DRM to support and validate non standard DRM 

    37 *  individual constraints (i.e. constraints other than "IMSI:" or "WIM:")

    38 *

    39 *  Must be implemented within a DLL named KDRMIndividualConstraintExtensionDll 

    40 *  which exports a non leaving factory method at ordinal 1 returning 

    41 *  MDRMIndividualConstraintExtension* or NULL

    42 *

    43 *  The DRM engine will only load and use this DLL if it exists.

    44 *

    45 *  @since Series60_3.1

    46 */

    47 class MDRMIndividualConstraintExtension

    48     {

    49     public: // New functions

    50 

    51         /**

    52         * The method should be coded to append additional valid individual

    53         * constraint strings to the supplied array.

    54         * 

    55         * Constraints must be of the format "<alpha string>:<digit string>"

    56         *

    57         * @since Series60_3.1

    58         * @param aConstraint array of individual constraint strings

    59         * @param aMobilePhone optional connected session to RMobilePhone, if

    60         *        not supplied then a new session will be created

    61         * @return void

    62         */

    63         virtual void AppendConstraintsL(RPointerArray<HBufC8>& aConstraint,

    64             RMobilePhone* aMobilePhone = NULL) =0;

    65 

    66         /**

    67         * This method should be coded to Release any resources. CBase derived classes

    68         * should call delete this.

    69         * @since Series60_3.1

    70         * @return void

    71         */

    72         virtual void Release() =0;

    73     };

    74 

    75 #endif //__DRMINDIVIDUALCONSTRAINTEXTENSION_H__

    76 

    77 // End of File