Collapse all Symbian^3 Application Developer Library

ContactGuid Class Reference

class ContactGuid

A globally unique identifier enquiry utility.

Each contact item has a unique identifier, stored as a descriptor. It is referred to as the 'UID string'. This is a combination of the unique identifier of the database in which the contact item was created, the contact item ID and the date/time of the contact item's creation. ContactGuid provides a single static exported function to enquire whether an item was created in a specified database.

Public Member Functions
HBufC *	CreateGuidLC (const TDesC &, TContactItemId , TInt64 )
HBufC *	CreateGuidLC (const TTime &, TContactItemId , TInt64 )
HBufC *	CreateGuidLC ( TContactItemId , TInt64 )
IMPORT_C TBool	GetCreationDate ( TDes &, TInt64 )
IMPORT_C TContactItemId	IsLocalContactUidString (const TDesC &, TInt64 )

Member Functions Documentation

CreateGuidLC(const TDesC &, TContactItemId, TInt64)

HBufC *	CreateGuidLC	(	const TDesC &	aCreationDate,
			TContactItemId	aId,
			TInt64	aMachineUniqueId
		)	[static]

Parameters

const TDesC & aCreationDate
TContactItemId aId
TInt64 aMachineUniqueId

CreateGuidLC(const TTime &, TContactItemId, TInt64)

HBufC *	CreateGuidLC	(	const TTime &	aCreationDate,
			TContactItemId	aId,
			TInt64	aMachineUniqueId
		)	[static]

Parameters

const TTime & aCreationDate
TContactItemId aId
TInt64 aMachineUniqueId

CreateGuidLC(TContactItemId, TInt64)

HBufC *	CreateGuidLC	(	TContactItemId	aId,
			TInt64	aMachineUniqueId
		)	[static]

Parameters

TContactItemId aId
TInt64 aMachineUniqueId

GetCreationDate(TDes &, TInt64)

IMPORT_C TBool	GetCreationDate	(	TDes &	aString,
			TInt64	aMachineUniqueId
		)	[static]

Parameters

TDes & aString
TInt64 aMachineUniqueId

IsLocalContactUidString(const TDesC &, TInt64)

IMPORT_C TContactItemId	IsLocalContactUidString	(	const TDesC &	aString,
			TInt64	aMachineUniqueId
		)	[static]

Tests whether a contact item was created in the database with the unique ID specified. If so, the item's contact item ID is returned. If not, returns KErrNotFound.

Parameters

const TDesC & aString	The contact item's UID string. Use CContactItem::UidStringL() to get a pointer to the item's UID string.
TInt64 aMachineUniqueId	The database's unique ID. This can be found by calling CContactDatabase::MachineId().