Categories: Symbian C++ | Code Examples | PIM | S60 3rd Edition

This page was last modified 07:08, 17 April 2008.

From Forum Nokia Wiki

Knowledge Base Home

Overview

This snippet shows a simple function implementation to import one or more vCards from a given file to the default contacts database.

This snippet can be self-signed.

MMP file

The following capabilities and libraries are required:

CAPABILITY WriteUserData

LIBRARY  euser.lib
LIBRARY  estor.lib 
LIBRARY  efsrv.lib
LIBRARY  cntmodel.lib

Source file

#include <e32cmn.h>   //TUid
#include <e32std.h>   //User
#include <e32base.h>  //CArrayPtr, CleanupStack
#include <e32def.h>   //TBool
#include <s32file.h>  //RFileReadStream
#include <f32file.h>  //RFs
#include <cntdb.h>    //CContactDatabase
#include <cntitem.h>  //CContactItem

TBool ImportVCardL(const TDesC& aFileName)
{
  RFs fileSession;
  RFile file;
  TBool result = EFalse;
  
  User::LeaveIfError(fileSession.Connect());
  CleanupClosePushL(fileSession);
  
  if (file.Open(fileSession, aFileName, EFileRead) != KErrNone)
    {
    //failed to open the file
    CleanupStack::PopAndDestroy(); //fileSession
    return EFalse;
    }
  CleanupClosePushL(file);
 
  //open a read stream to the file
  RFileReadStream inputFileStream(file);
  CleanupClosePushL(inputFileStream);
 
  //open the default contacts database
  CContactDatabase* contactsDb = CContactDatabase::OpenL();
  CleanupStack::PushL(contactsDb);
 
  //KVersitEntityUidVCard is used to identify a vCard
  TUid uid = TUid::Uid(KVersitEntityUidVCard);
    
  //import one or more vCards from the read stream
  CArrayPtr<CContactItem>* imported = contactsDb->ImportContactsL(uid,
                inputFileStream,
                result,
                CContactDatabase::ETTFormat);
  
  //caller has ownership of the array and frees allocated memory 
  imported->ResetAndDestroy();
  delete imported;
 
  CleanupStack::PopAndDestroy(4);  //contactsDb,inputFileStream,
                  //file,fileSession
    
  return result;
}

Postconditions

One or more vCards from the given file are imported to the default contacts database. ETrue is returned to the caller or in case of an error, EFalse is returned.

See also

CS000901 - Exporting a vCard item to a file