CVPbkContactCopier Class Reference

#include <app/CVPbkContactCopier.h>

Link against: VPbkEng.lib

class CVPbkContactCopier : public CBase

Inherits from

Public Member Enumerations
enum	TVPbkContactCopyFlags { EVPbkSimpleContactCopy, EVPbkUseStoreSpecificCopyPolicy, EVPbkUsePlatformSpecificDuplicatePolicy }

Public Member Functions
	~CVPbkContactCopier()
IMPORT_C MVPbkContactOperationBase *	CopyContactsL(TUint32, const MVPbkContactLinkArray &, MVPbkContactStore *, CVPbkContactLinkArray &, MVPbkBatchOperationObserver &)
IMPORT_C CVPbkContactCopier *	NewL(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()

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

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

Enumerator	Value	Description
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.

~CVPbkContactCopier

(

)

Destructor.

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

Copies a set of contacts to the target store.

Parameter	Description
aContactCopyFlags	A set of TVPbkContactCopyFlags
aSourceContactLinks	Source contact links
aTargetStore	Target of the copy operation. If NULL this behaves like duplicate.
aCopiedContactLinks	The results of the copy. Copied contacts are added to this array.
aObserver	An observer for asynchronous operation

Returns: A copy contact operation

NewL

(

aContactManager

)

[static]

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

Parameter	Description
aContactManager	The contact manager for getting stores.

Returns: A new instance of this class