javacommons/security/legacysupport/midp2userpreferences/inc/MMIDletSuiteInfo.h
branchRCL_3
changeset 14 04becd199f91
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/javacommons/security/legacysupport/midp2userpreferences/inc/MMIDletSuiteInfo.h	Tue Apr 27 16:30:29 2010 +0300
@@ -0,0 +1,132 @@
+/*
+* Copyright (c) 2002-2003 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 MMIDLETSUITEINFO_H
+#define MMIDLETSUITEINFO_H
+
+#include <e32base.h>
+
+namespace MIDP
+{
+
+/**
+ * Interface class to provide API for maintaining information about a MIDlet Suite.
+ */
+class MMIDletSuiteInfo
+{
+public:
+    /** Enumeration used to refer to a particular property. */
+    enum TPropertyId
+    {
+        EHomeDir = 1,
+        EProtectionDomain
+    };
+
+public:
+
+    /** Destructor */
+    virtual ~MMIDletSuiteInfo() = 0;
+
+    /**
+     * Return the suite's id.
+     * @return  The integer id.
+     */
+    virtual TUint32 Id(void) const = 0;
+
+    /**
+     * Return the suite's name information.
+     * @return  Descriptor reference containing the name information.
+     */
+    virtual const TDesC& Name(void) const = 0;
+
+    /**
+     * Return the suite's vendor information.
+     * @return  Descriptor reference containing the vendor information.
+     */
+    virtual const TDesC& Vendor(void) const = 0;
+
+    /**
+     * Return the suite's signer information.
+     * @return  Descriptor reference containing the signer information.
+     */
+    virtual const TDesC& Signer(void) const = 0;
+
+    /**
+     * Return the path to the jar file
+     * @return  Descriptor reference containing the jar path
+     */
+    virtual const TDesC& JarPath(void) const = 0;
+
+    /**
+      * Return the "country" info contained in the suite's signer cert
+      * (C attribute of Subject field of certificate)
+      * @return  Pointer to descriptor containing the "country",
+      *          NULL if there is no "country" information in certificate.
+      * Ownership is retained (not transferred to caller)
+      */
+    virtual const HBufC* SignerCertCountry(void) const = 0;
+
+    /**
+      * Return the "organisation" info contained in the suite's signer cert
+      * (O attribute of Subject field of certificate)
+      * @return  Pointer to descriptor containing the "organisation".
+      *          NULL if there is no "organisation" information in certificate.
+      * Ownership is retained (not transferred to caller)
+      */
+    virtual const HBufC* SignerCertOrg(void) const = 0;
+
+    /**
+     * Return the common name contained in the suite's signer cert
+     * (CN attribute of Subject field)
+     * @return  Pointer to descriptor containing the common name.
+     *          NULL if there is no "common name" information in certificate.
+     * Ownership is retained (not transferred to caller)
+     */
+    virtual const HBufC* SignerCertCN(void) const = 0;
+
+    /**
+     * Return whether the midlet is signed or not
+     * @return  whether the midlet is signed or not
+     */
+    virtual TBool IsSigned(void) const = 0;
+
+    /**
+     * Retrieve the property specified by aId.
+     * @see TPropertyId
+     * @param   aId
+     *          Used to specify the property to retrieve.
+     * @param   aValue
+     *          Descriptor to receive the property value.
+     * @return  KErrNone if successful, else a system wide error code.
+     */
+    virtual TInt PropertyL(TInt aId, TPtrC& aValue) const = 0;
+};
+
+inline MMIDletSuiteInfo::~MMIDletSuiteInfo()
+{
+}
+
+} // end of namespace MIDP
+
+#endif // MMIDLETSUITEINFO_H