View source

__NOTOC__
__NOEDITSECTION__
{{KBTS}}
{{KnowledgeBase
|id=TSS001441
|platform=S60 3rd Edition, FP1<br>S60 3rd Edition, FP2
|devices=Tested on Nokia N95
|category=Symbian C++
|subcategory=Signing and Certification
|creationdate=June 23, 2009
|keywords=CUnifiedCertStore
}}
== Description ==
The <tt>CUnifiedCertStore</tt> class provides a certificate store whose contents are the sum of the contents of all certificate store implementations on the device. It is intended as the single point of access for clients wishing to use certificate stores.

==Solution==
The following sample code shows how to retrieve the certificates present on the device.

'''MyClass.h'''

<code cpp>
 #include <unifiedcertstore.h>     // link against certstore.lib 
 #include <f32file.h>              // link against efsrv.lib
 #include <ccertattributefilter.h> // link against ctframework.lib
 
 // Desclaration of CMyClass
    
  class CMyClass : public CActive
    {
  public:
  
    enum TState
      {
      EGetCerts,
      EInitialize
      };    
  
    static CMyClass* NewL();	
    ~CMyClass();
    
    void InitL();
    void DoListL();
    void PopulateListL();	
    
  protected: // From CActive   
    virtual void DoCancel();
    virtual void RunL();
    
  private: // Private constructors
    CMyClass();
    void ConstructL();
    
  private: // Data
  
    CUnifiedCertStore*          iCertStore;
    RMPointerArray<CCTCertInfo> iCerts;
    CActiveSchedulerWait        iWait;
    
    TState                      iCertCmd;
    RFs                         iFs;
    };
</code><br>

'''MyClass.cpp'''

<code cpp>
 #include "MyClass.h"
  
  
  CMyClass* CMyClass::NewL()
    {
    CMyClass* self = new (ELeave) CMyClass;
    CleanupStack::PushL(self);
    self->ConstructL();
    CleanupStack::Pop(); // self
    return self;
    }
  
  
  CMyClass::CMyClass()
  : CActive(CActive::EPriorityStandard)
    {
    CActiveScheduler::Add( this );
    }
    
    
  CMyClass::~CMyClass()
    {
    Cancel();
    
    delete iCertStore;
    iFs.Close();
    iCerts.Close();
    }
  
  
  void CMyClass::ConstructL()
    {    
    User::LeaveIfError( iFs.Connect() );
    iCertStore = CUnifiedCertStore::NewL( iFs, EFalse );
    InitL();
    }
  
  
  void CMyClass::InitL()
    {
    if( IsActive() )
      {
      return;
      }
    
    iCertStore->Initialize( iStatus );
    SetActive();
    iCertCmd = EInitialize;
    iWait.Start();
    // RunL called when this completes
    }
  
  
  void CMyClass::DoListL()
    {
    CCertAttributeFilter* certFilter = CCertAttributeFilter::NewLC();
    certFilter->SetFormat( EX509Certificate );
    iCertStore->List(iCerts, *certFilter, iStatus);
    SetActive();
    iCertCmd = EGetCerts;
    iWait.Start();
    // RunL called when this completes
    
    CleanupStack::PopAndDestroy(); // certFilter
    }
  
  
  void CMyClass::RunL()
    {
    iWait.AsyncStop();
    if(iStatus == KErrNone)
      {
      switch(iCertCmd)
        {
        case EInitialize:
          {
          DoListL();
          PopulateListL();
          break;
          }
        default:
          break;
        }
      }
    }
  
  
  void CMyClass::DoCancel()
    {
    switch(iCertCmd)
      {
      case EInitialize:
        {
        iCertStore->CancelInitialize();
        break;
        }
      case EGetCerts:
        {
        iCertStore->CancelList();
        break;
        }
      default:
        break;
      }
    }
  
  
  void CMyClass::PopulateListL()
    {
    for( TInt i = 0; i < iCerts.Count(); i++ )
      {
      TBuf<KMaxCertLabelLength>   iCertLabel;
      iCertLabel.Copy( iCerts[i]->Label() );
      // ... process each cert label here
      }
    }
</code><br>
'''Required capabilities:''' ReadDeviceData

[[Category:Symbian C++]][[Category:Technical Solution]][[Category:S60 3rd Edition, Feature Pack 1 ]][[Category:S60 3rd Edition, Feature Pack 2 ]][[Category:Signing and Certification]]