Collapse all Symbian^3 Product Developer Library

CVPbkContactCopier Class Reference

class CVPbkContactCopier : public CBase

Virtual Phonebook contact copier. Copies source contacts to the target store according to copying rules.

VPbkEng.lib

Inherits from

CVPbkContactCopier
- CBase

Public Member Functions
	~CVPbkContactCopier()
IMPORT_C MVPbkContactOperationBase *	CopyContactsL(TUint32, const MVPbkContactLinkArray &, MVPbkContactStore *, CVPbkContactLinkArray &, MVPbkBatchOperationObserver &)
IMPORT_C CVPbkContactCopier *	NewL(CVPbkContactManager &)

Private Member Functions
	CVPbkContactCopier(CVPbkContactManager &)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Public Member Enumerations
enum	TVPbkContactCopyFlags { EVPbkSimpleContactCopy = 0, EVPbkUseStoreSpecificCopyPolicy = 0x01, EVPbkUsePlatformSpecificDuplicatePolicy = 0x02 }

Private Attributes
CVPbkContactManager &	iContactManager

Constructor & Destructor Documentation

CVPbkContactCopier(CVPbkContactManager &)

CVPbkContactCopier

(

CVPbkContactManager &

aContactManager

)

[private]

Parameters

CVPbkContactManager & aContactManager

~CVPbkContactCopier()

~CVPbkContactCopier

(

)

Destructor.

Member Functions Documentation

CopyContactsL(TUint32, const MVPbkContactLinkArray &, MVPbkContactStore *, CVPbkContactLinkArray &, MVPbkBatchOperationObserver &)

IMPORT_C MVPbkContactOperationBase *	CopyContactsL	(	TUint32	aContactCopyFlags,
			const MVPbkContactLinkArray &	aSourceContactLinks,
			MVPbkContactStore *	aTargetStore,
			CVPbkContactLinkArray &	aCopiedContactLinks,
			MVPbkBatchOperationObserver &	aObserver
		)

Copies a set of contacts to the target store.

Parameters

TUint32 aContactCopyFlags	A set of TVPbkContactCopyFlags
const MVPbkContactLinkArray & aSourceContactLinks	Source contact links
MVPbkContactStore * aTargetStore	Target of the copy operation. If NULL this behaves like duplicate.
CVPbkContactLinkArray & aCopiedContactLinks	The results of the copy. Copied contacts are added to this array.
MVPbkBatchOperationObserver & aObserver	An observer for asynchronous operation

NewL(CVPbkContactManager &)

IMPORT_C CVPbkContactCopier *

NewL

(

CVPbkContactManager &

aContactManager

)

[static]

Creates a new copier instance. Remember to open the stores first before starting any copy operation.

Parameters

CVPbkContactManager & aContactManager

The contact manager for getting stores.

Member Enumerations Documentation

Enum TVPbkContactCopyFlags

A set of flags for copying. Fastest copy is EVPbkSimpleContactCopy.

Enumerators

EVPbkSimpleContactCopy = 0	Copies a field if the target store supports the field type. Does not perform additional checks.
EVPbkUseStoreSpecificCopyPolicy = 0x01	Uses a store specific copy policy if found for the target store. Can do e.g field type conversion between source and target field types. Falls back to simple copy if the copy policy was not found for the store.
EVPbkUsePlatformSpecificDuplicatePolicy = 0x02	Finds duplicates before saving a contact if there is a copy policy for the store that can handle the possible merge of new and existing contact data. Falls back to simple copy if the copy policy was not found for the store.

Member Data Documentation

CVPbkContactManager & iContactManager

CVPbkContactManager &

iContactManager

[private]