wim/WimServer/inc/WimCertHandler.h
branchRCL_3
changeset 5 3b17fc5c9564
parent 0 164170e6151a
--- a/wim/WimServer/inc/WimCertHandler.h	Tue Feb 02 00:44:34 2010 +0200
+++ b/wim/WimServer/inc/WimCertHandler.h	Fri Feb 19 23:42:03 2010 +0200
@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies). 
+* Copyright (c) 2002-2010 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"
@@ -31,33 +31,33 @@
 
 /**
 *  Class for handling certificates in WIM card
-*  
+*
 *  @since Series60 2.1
 */
 class CWimCertHandler : public CBase
     {
     public:  // Constructors and destructor
-        
+
         /**
         * Two-phased constructor.
         */
         static CWimCertHandler* NewL();
-        
+
         /**
         * Destructor.
         */
         virtual ~CWimCertHandler();
 
     public: // New functions
-        
+
         /**
         * Fetches certificates from WIM card.
         * @param aMessage Encapsulates a client request.
         * @param aWimMgmt Pointer to WIM reference management class.
         */
-        void GetCertificatesFromWimL( const RMessage2& aMessage, 
+        void GetCertificatesFromWimL( const RMessage2& aMessage,
                                       CWimMemMgmt* aWimMgmt );
-        
+
         /**
         * Fetches certificate extra information from WIM card.
         * Extra information includes trusted usage and CDF referense
@@ -65,23 +65,23 @@
         * @param aMessage Encapsulates a client request.
         * @param aWimMgmt Pointer to WIM reference management class.
         */
-        void GetExtrasFromWimL( const RMessage2& aMessage, 
+        void GetExtrasFromWimL( const RMessage2& aMessage,
                                 CWimMemMgmt* aWimMgmt );
-        
+
         /**
         * Fetches count of certicates in certain WIM card.
         * @param aMessage Encapsulates a client request.
         * @param aWimMgmt Pointer to WIM reference management class.
         */
-        void GetCerticateCountL( const RMessage2& aMessage, 
+        void GetCerticateCountL( const RMessage2& aMessage,
                                  CWimMemMgmt* aWimMgmt ) const;
 
 
         /**
         * Stores certificate to the WIM card.
         * @since Series60 2.6
-        * @param aRequest Enumerator used in message 
-                          passing between client and server.   
+        * @param aRequest Enumerator used in message
+                          passing between client and server.
         * @param aMessage Encapsulates a client request.
         */
         void StoreCertificateL( TWimServRqst aRequest,
@@ -95,11 +95,11 @@
         */
         void RemoveCertificateL( const RMessage2& aMessage,
                                  CWimMemMgmt* aWimMgmt ) const;
-        
+
         /**
         * Fetches certificate details.
-        * @param aOpCode Enumerator used in message 
-                          passing between client and server.   
+        * @param aOpCode Enumerator used in message
+                          passing between client and server.
         * @param aMessage Encapsulates a client request.
         */
         void GetCertificateDetailsL( TWimServRqst aOpCode,
@@ -111,14 +111,14 @@
         * @param aMessage Encapsulates a client request.
         */
         void ExportPublicKeyL( const RMessage2& aMessage ) const;
-        
-        
+
+
         TBool SanityCheck( TUint32 aCertRef );
-        
+
         TBool CheckReadCapsForUsage( const RMessage2& aMsg,
                                        TUint8 aUsage );
-        
-        
+
+
         WIMI_STAT ResolveCertUsage( const RMessage2& aMsg,
                                                 TUint8& aUsage );
 
@@ -143,7 +143,7 @@
                                              TInt8 aUsage,
                                              TUint8& aCertNum,
                                              TUint32* aCertRefLst,
-                                             TWimCertInfo* aCertInfoLst,  
+                                             TWimCertInfo* aCertInfoLst,
                                              const RMessage2& aMessage );
 
         /**
@@ -154,7 +154,7 @@
         * @return TInt      KErrNone or KErrArgument
         */
         TInt CopyCertificateInfo( TWimCertInfo& aCertInfo,
-                                   WIMI_Ref_t* aCert,  
+                                   WIMI_Ref_t* aCert,
                                    const RMessage2& aMessage );
 
         /**
@@ -165,7 +165,7 @@
         * @param aMessage   Encapsulates a client request.
         * @return Status returned by WIMI. See in WimClsv.h.
         */
-        WIMI_STAT GetExtrasFromWimRefL( WIMI_Ref_t* aTmpWimRef,                                  
+        WIMI_STAT GetExtrasFromWimRefL( WIMI_Ref_t* aTmpWimRef,
                                         TInt8 aUsage,
                                         TDesC8& aKeyHash,
                                         const RMessage2& aMessage );
@@ -187,8 +187,8 @@
         * @param aUsage     Certificate usage.
         * @return Status returned by WIMI. See in wimclsv.h.
         */
-        WIMI_STAT GetCertificateCountByWIM( WIMI_Ref_t* aRef, 
-                                            TUint8& aCertCount, 
+        WIMI_STAT GetCertificateCountByWIM( WIMI_Ref_t* aRef,
+                                            TUint8& aCertCount,
                                             TUint8 aUsage ) const;
 
         /**
@@ -202,6 +202,13 @@
                                   TDes8& aPublicKey,
                                   const TUint8 aCertType ) const;
 
+        /**
+         * Returns WIM reference. Returns WIM ref cached in aWimMgmt, or
+         * fetches new using WIMI_GetWIMRef() and caches it in aWimMgmt.
+         * @since Serier60 5.2
+         * @param aWimMgmt  WIM memory manager
+         */
+        WIMI_Ref_t* MainWimRef( CWimMemMgmt& aWimMgmt ) const;
 
     private:    // Data
         CWimUtilityFuncs* iWimUtilFuncs;
@@ -209,5 +216,5 @@
     };
 
 #endif      // CWIMCERTHANDLER_H
-    
+
 //End of File